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

Récupère le chemin d’accès actuel relatif au bloc de métadonnées racine.

Syntaxe

HRESULT GetLocation(
  [in]      UINT  cchMaxLength,
  [in, out] WCHAR *wzNamespace,
  [out]     UINT  *pcchActualLength
);

Paramètres

[in] cchMaxLength

Type : UINT

Longueur de la mémoire tampon wzNamespace .

[in, out] wzNamespace

Type : WCHAR*

Pointeur qui reçoit l’emplacement de l’espace de noms actuel.

[out] pcchActualLength

Type : UINT*

Longueur réelle de la mémoire tampon nécessaire pour récupérer l’emplacement de l’espace de noms actuel.

Valeur retournée

Type : HRESULT

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

Remarques

Si vous passez la valeur NULL à wzNamespace, GetLocation ignore cchMaxLength et retourne la longueur de mémoire tampon requise pour stocker le chemin d’accès dans la variable vers laquelle pointe pcchActualLength .

Si le lecteur de requête est relatif au haut de la hiérarchie de métadonnées, il retourne une chaîne mono-char.

Si le lecteur de requête est relatif à un bloc de métadonnées imbriqué, cette méthode retourne le chemin d’accès au lecteur de requête actuel.

Configuration requise

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

Voir aussi

Conceptuel

IWICMetadataQueryReader

Vue d’ensemble de la lecture et de l’écriture de métadonnées d’image

Vue d’ensemble des métadonnées WIC