Metodo IWICMetadataQueryReader::GetMetadataByName (wincodec.h)

Articolo
03/09/2024

Recupera il blocco di metadati o l'elemento identificato da un'espressione di query di metadati.

Sintassi

HRESULT GetMetadataByName(
  [in]      LPCWSTR     wzName,
  [in, out] PROPVARIANT *pvarValue
);

Parametri

[in] wzName

Tipo: LPCWSTR

Espressione di query per il blocco o l'elemento di metadati richiesti.

[in, out] pvarValue

Tipo: PROPVARIANT*

Quando termina, questo metodo contiene il blocco di metadati o l'elemento richiesto.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

GetMetadataByName usa espressioni di query di metadati per accedere ai metadati incorporati. Per altre informazioni sul linguaggio di query dei metadati, vedere Panoramica del linguaggio di query sui metadati.

Se esistono più blocchi o elementi espressi dalla stessa espressione di query, verrà restituito il primo blocco di metadati o l'elemento trovato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP2, Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	wincodec.h
Libreria	Windowscodecs.lib
DLL	Windowscodecs.dll