Metodo IWMDMMetaData::QueryByName (mswmdm.h)

Articolo
02/29/2024

Il metodo QueryByName recupera il valore di una proprietà specificata in base al nome.

Sintassi

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

Parametri

[in] pwszTagName

Puntatore a una stringa con terminazione Null a caratteri wide che specifica il nome della proprietà. In Costanti metadati viene fornito un elenco di costanti dei nomi di proprietà standard.

[out] pType

Valore enumerato WMDM_TAG_DATATYPE che descrive il tipo di dati recuperati da pValue.

[out] pValue

Puntatore a un puntatore a una matrice di byte che riceve il contenuto del valore se il metodo ha esito positivo. Windows Media Gestione dispositivi alloca questa memoria e il chiamante deve liberarlo usando CoTaskMemFree.

[out] pcbLength

Puntatore alle dimensioni, in byte, della matrice di byte ppValue. Se il valore è una stringa, include il carattere di terminazione.

Valore restituito

Il metodo restituisce un valore HRESULT. Tutti i metodi di interfaccia in Windows Media Gestione dispositivi possono restituire una delle classi di codici di errore seguenti: