IWMDMMetaData::QueryByName-Methode (mswmdm.h)

Artikel
03/06/2024

Die QueryByName-Methode ruft den Wert einer Eigenschaft ab, die durch den Namen angegeben wird.

Syntax

HRESULT QueryByName(
  [in]  LPCWSTR           pwszTagName,
  [out] WMDM_TAG_DATATYPE *pType,
  [out] BYTE              **pValue,
  [out] UINT              *pcbLength
);

Parameter

[in] pwszTagName

Zeiger auf eine Breitzeichen-NULL-endende Zeichenfolge, die den Eigenschaftennamen angibt. Eine Liste der Standardeigenschaftennamenkonstanten wird unter Metadatenkonstanten angegeben.

[out] pType

Ein WMDM_TAG_DATATYPE aufgezählter Wert, der den Typ der von pValue abgerufenen Daten beschreibt.

[out] pValue

Zeiger auf einen Zeiger auf ein Bytearray, das den Inhalt des Werts empfängt, wenn die Methode erfolgreich ist. Windows Media Geräte-Manager weist diesen Arbeitsspeicher zu, 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: