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

Artículo
03/13/2024

Recupera el bloque de metadatos o el elemento identificado por una expresión de consulta de metadatos.

Sintaxis

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

Parámetros

[in] wzName

Tipo: LPCWSTR

Expresión de consulta al bloque o elemento de metadatos solicitados.

[in, out] pvarValue

Tipo: PROPVARIANT*

Cuando este método vuelve, contiene el bloque de metadatos o el elemento solicitado.

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

GetMetadataByName usa expresiones de consulta de metadatos para acceder a los metadatos incrustados. Para obtener más información sobre el lenguaje de consulta de metadatos, consulte Información general sobre el lenguaje de consulta de metadatos.

Si existen varios bloques o elementos expresados por la misma expresión de consulta, se devolverá el primer bloque de metadatos o elemento encontrado.

Requisitos

Requisito	Value
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