Compartilhar via


Método IWICMetadataWriter::SetValueByIndex (wincodecsdk.h)

Define o item de metadados para o índice especificado.

Sintaxe

HRESULT SetValueByIndex(
  [in] UINT              nIndex,
  [in] const PROPVARIANT *pvarSchema,
  [in] const PROPVARIANT *pvarId,
  [in] const PROPVARIANT *pvarValue
);

Parâmetros

[in] nIndex

Tipo: UINT

O índice a ser colocado no item de metadados.

[in] pvarSchema

Tipo: const PROPVARIANT*

Ponteiro para a propriedade de esquema do item de metadados.

[in] pvarId

Tipo: const PROPVARIANT*

Ponteiro para a propriedade ID do item de metadados.

[in] pvarValue

Tipo: const PROPVARIANT*

Ponteiro para o valor de metadados a ser definido no índice fornecido.

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

Depois de remover um item, espere que os itens de metadados restantes se movam para cima para ocupar o local do item de metadados desocupado. Portanto, os índices para os itens de metadados restantes, bem como a contagem, serão alterados.

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 wincodecsdk.h
Biblioteca Windowscodecs.lib
DLL Windowscodecs.dll