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

A interface GetBufferValue recupera um valor de matriz de bytes (tipo VT_VECTOR ou VT_UI1) especificado por uma chave.

Sintaxe

HRESULT GetBufferValue(
  [in]  REFPROPERTYKEY key,
  [out] BYTE           **ppValue,
  [out] DWORD          *pcbValue
);

[in] key

Uma chave REFPROPERTYKEY que especifica o item a ser recuperado.

[out] ppValue

Um ponteiro para o valor BYTE* recuperado. O chamador deve liberar a memória chamando CoTaskMemFree.

[out] pcbValue

Um ponteiro para o tamanho de ppValue, em bytes.

O método retorna um HRESULT. Os valores retornados possíveis são mostrados na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
DISP_E_TYPEMISMATCH	A propriedade especificada por key não é um tipo BYTE*.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	A propriedade especificada por key não está na coleção.
E_INVALIDARG	Um ou mais argumentos especificados não são válidos.

Não há suporte para a recuperação de um buffer NULL ou de tamanho zero e retornará E_INVALIDARG.

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