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

  • Artículo

Recupera la ruta de acceso actual relativa al bloque de metadatos raíz.

Sintaxis

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

Parámetros

[in] cchMaxLength

Tipo: UINT

Longitud del búfer wzNamespace .

[in, out] wzNamespace

Tipo: WCHAR*

Puntero que recibe la ubicación del espacio de nombres actual.

[out] pcchActualLength

Tipo: UINT*

Longitud real del búfer necesaria para recuperar la ubicación del espacio de nombres actual.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Si pasa NULL a wzNamespace, GetLocation omite cchMaxLength y devuelve la longitud de búfer necesaria para almacenar la ruta de acceso en la variable a la que apunta pcchActualLength .

Si el lector de consultas es relativo a la parte superior de la jerarquía de metadatos, devolverá una cadena de un solo carácter.

Si el lector de consultas es relativo a un bloque de metadatos anidado, este método devolverá la ruta de acceso al lector de consultas actual.

Requisitos

   
Cliente mínimo compatible Windows XP con SP2, Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado wincodec.h
Library Windowscodecs.lib
Archivo DLL Windowscodecs.dll

Consulte también

Conceptual

IWICMetadataQueryReader

Información general sobre la lectura y escritura de metadatos de imagen

Introducción a los metadatos de WIC