Método IWICMetadataQueryWriter::SetMetadataByName (wincodec.h)

Artigo
03/03/2024

Define um item de metadados como um local específico.

Sintaxe

HRESULT SetMetadataByName(
  [in] LPCWSTR           wzName,
  [in] const PROPVARIANT *pvarValue
);

Parâmetros

[in] wzName

Tipo: LPCWSTR

O nome do item de metadados.

[in] pvarValue

Tipo: const PROPVARIANT*

Os metadados a serem definidos.

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

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

Se o valor definido for um bloco de metadados aninhado, use o tipo VT_UNKNOWN variante e pvarValue apontando para o IWICMetadataQueryWriter do novo bloco de metadados.
A ordenação de itens de metadados fica a critério do gravador de consulta, pois os locais relativos não são especificados.

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