Método IPortableDeviceValues::GetBufferValue

El método GetBufferValue recupera un valor de matriz de bytes (tipo VT_VECTOR | VT_UI1) especificado por una clave.

Sintaxis

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

key [in]: Clave REFPROPERTYKEY que especifica el elemento que se va a recuperar.
ppValue [out]: Puntero al valor BYTE* recuperado. El autor de la llamada es responsable de liberar la memoria llamando a CoTaskMemFree.
pcbValue [out]: Puntero al tamaño de ppValue, en bytes.

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
DISP_E_TYPEMISMATCH	La propiedad especificada por la clave no es un tipo BYTE*.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	La propiedad especificada por la clave no está en la colección.

No se admite la recuperación de un búfer NULL o un búfer de tamaño cero.

Requisito	Value
Encabezado	PortableDeviceTypes.h
Biblioteca	PortableDeviceGUIDs.lib