Méthode IWICMetadataQueryReader ::GetMetadataByName (wincodec.h)

Article
03/03/2024

Récupère le bloc de métadonnées ou l’élément identifié par une expression de requête de métadonnées.

Syntaxe

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

Paramètres

[in] wzName

Type : LPCWSTR

Expression de requête du bloc ou de l’élément de métadonnées demandé.

[in, out] pvarValue

Type : PROPVARIANT*

Lorsque cette méthode retourne, contient le bloc de métadonnées ou l’élément demandé.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

GetMetadataByName utilise des expressions de requête de métadonnées pour accéder aux métadonnées incorporées. Pour plus d’informations sur le langage de requête de métadonnées, consultez Vue d’ensemble du langage de requête de métadonnées.

S’il existe plusieurs blocs ou éléments exprimés par la même expression de requête, le premier bloc de métadonnées ou élément trouvé est retourné.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP avec SP2, Windows Vista [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	wincodec.h
Bibliothèque	Windowscodecs.lib
DLL	Windowscodecs.dll