Método IPortableDeviceValues::SetBufferValue

O método SetBufferValue adiciona um novo valor BYTE* (tipo VT_VECTOR | VT_UI1) ou substitui um existente.

Sintaxe

HRESULT SetBufferValue(
  [in] REFPROPERTYKEY key,
  [in] BYTE           *pValue,
  [in] DWORD          cbValue
);

Parâmetros

chave [in]

UMA REFPROPERTYKEY que especifica o item a ser criado ou substituído.

pValue [in]

Um BYTE* que contém os dados a serem gravados no item. Os dados de buffer enviados são copiados para a interface, para que o chamador possa liberar esse buffer depois de fazer essa chamada.

cbValue [in]

O tamanho do valor apontado por pValue, em bytes.

Valor retornado

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Comentários

Se um valor existente tiver a mesma chave especificada pelo parâmetro key , ele substituirá o valor existente sem nenhum aviso. A memória de chave existente é liberada adequadamente.

Não há suporte para a configuração de um nulo ou um buffer de tamanho zero.

Requisitos

Requisito	Valor
parâmetro	PortableDeviceTypes.h
Biblioteca	PortableDeviceGUIDs.lib

Confira também

IPortableDeviceValues Interface

IPortableDeviceValues::GetBufferValue