Share via

IAttributeGet::GetAttribIndexed Method

  • Article

This topic applies to Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 and later.
The GetAttribIndexed method returns an attribute value, specified by index.

Syntax

HRESULT GetAttribIndexed(
  [in]       LONG lIndex,
  [out]      GUID *pguidAttribute,
  [in, out]  BYTE *pbAttribute,
  [in, out]  DWORD *pdwAttributeLength
);

Parameters

  • lIndex [in]
    Zero-based index of the attribute. To get the number of attributes, call IAttributeGet::GetCount.

  • pguidAttribute [out]
    Receives the GUID for this attribute.

  • pbAttribute [in, out]
    Pointer to a buffer that receives the attribute value. This parameter can be NULL.

  • pdwAttributeLength [in, out]
    If pbAttribute is NULL, this parameter receives the size of the attribute data, in bytes. If pbAttribute is non-NULL, this parameter specifies the size of the pbAttribute buffer, in bytes.

Return Value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description

E_INVALIDARG

The lIndex parameter is out of range.

S_OK

The method succeeded.

Requirements

Header Declared in Dsattrib.h.

See Also

IAttributeGet Interface

Send comments about this topic to Microsoft

Build date: 12/4/2008