Método IPortableDeviceValues::GetBufferValue

O método GetBufferValue recupera um valor de matriz de bytes (tipo VT_VECTOR | VT_UI1) especificado por uma chave.

Sintaxe

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

chave [in]: Uma chave REFPROPERTYKEY que especifica o item a ser recuperado.
ppValue [out]: Ponteiro para o valor BYTE* recuperado. O chamador é responsável por liberar a memória chamando CoTaskMemFree.
pcbValue [out]: Ponteiro para o tamanho de ppValue, em bytes.

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.
DISP_E_TYPEMISMATCH	A propriedade especificada por chave não é um tipo BYTE*.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	A propriedade especificada por key não está na coleção.

Não há suporte para recuperar um buffer NULL ou um buffer de tamanho zero.

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