IWMDMMetaData::QueryByIndex-Methode (mswmdm.h)

Artikel
02/29/2024

Die QueryByIndex-Methode ruft den Wert einer Durch index angegebenen Eigenschaft ab.

Syntax

HRESULT QueryByIndex(
  [in]  UINT              iIndex,
  [out] WCHAR             **ppwszName,
  [out] WMDM_TAG_DATATYPE *pType,
  [out] BYTE              **ppValue,
  [out] UINT              *pcbLength
);

Parameter

[in] iIndex

Ganze Zahl, die den nullbasierten Index der Eigenschaft angibt. Die Anzahl der Elemente wird über den GetItemCount-Aufruf abgerufen.

[out] ppwszName

Der Name der Eigenschaft. Windows Media Geräte-Manager weist diesen Arbeitsspeicher zu, und der Aufrufer muss ihn mit CoTaskMemFree freigeben.

[out] pType

Ein WMDM_TAG_DATATYPE aufgezählter Wert, der den Typ der in ppValue zurückgegebenen Daten beschreibt.

[out] ppValue

Zeiger auf einen Zeiger auf ein Bytearray, das den Inhalt des Werts empfängt, wenn die Methode erfolgreich ist. Dieser Arbeitsspeicher wird von Windows Media Geräte-Manager zugeordnet, und der Aufrufer muss ihn mit CoTaskMemFree freigeben.

[out] pcbLength

Zeiger auf die Größe des Bytearrays ppValue in Bytes. Wenn der Wert eine Zeichenfolge ist, schließt dies das Beendigungszeichen ein.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Alle Schnittstellenmethoden in Windows Media Geräte-Manager können eine der folgenden Klassen von Fehlercodes zurückgeben: