Método IPortableDeviceValues::SetBufferValue (portabledevicetypes.h)

Adiciona um novo valor BYTE* (tipo VT_VECTOR ou VT_UI1) ou substitui um existente.

Sintaxe

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

Parâmetros

[in] key

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

[in] pValue

Um ponteiro para 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.

[in] cbValue

O tamanho do valor apontado por pValue, em bytes.

Retornar valor

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

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

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.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	portabledevicetypes.h

Confira também

IPortableDeviceValues Interface

IPortableDeviceValues::GetBufferValue