Metodo IWICMetadataQueryReader::GetLocation (wincodec.h)

Recupera il percorso corrente relativo al blocco di metadati radice.

Sintassi

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

Parametri

[in] cchMaxLength

Tipo: UINT

Lunghezza del buffer wzNamespace .

[in, out] wzNamespace

Tipo: WCHAR*

Puntatore che riceve la posizione dello spazio dei nomi corrente.

[out] pcchActualLength

Tipo: UINT*

Lunghezza effettiva del buffer necessaria per recuperare il percorso dello spazio dei nomi corrente.

Valore restituito

Tipo: HRESULT

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

Commenti

Se si passa NULL a wzNamespace, GetLocation ignora cchMaxLength e restituisce la lunghezza del buffer necessaria per archiviare il percorso nella variabile a cui fa riferimento pcchActualLength .

Se il lettore di query è relativo all'inizio della gerarchia dei metadati, restituirà una stringa a caratteri singoli.

Se il lettore di query è relativo a un blocco di metadati annidato, questo metodo restituirà il percorso al lettore di query corrente.

Requisiti

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

Vedi anche

Informazioni concettuali

IWICMetadataQueryReader

Panoramica della lettura e della scrittura dei metadati dell'immagine

Panoramica dei metadati WIC