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

Artigo
03/03/2024

Recupera o bloco de metadados ou o item identificado por uma expressão de consulta de metadados.

Sintaxe

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

Parâmetros

[in] wzName

Tipo: LPCWSTR

A expressão de consulta para o bloco ou item de metadados solicitado.

[in, out] pvarValue

Tipo: PROPVARIANT*

Quando esse método retorna, contém o bloco de metadados ou o item solicitado.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

GetMetadataByName usa expressões de consulta de metadados para acessar metadados inseridos. Para obter mais informações sobre a linguagem de consulta de metadados, consulte a Visão geral da linguagem de consulta de metadados.

Se existirem vários blocos ou itens expressos pela mesma expressão de consulta, o primeiro bloco de metadados ou item encontrado será retornado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP com SP2, Windows Vista [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	wincodec.h
Biblioteca	Windowscodecs.lib
DLL	Windowscodecs.dll