Metodo IPortableDeviceValues::GetBufferValue

Il metodo GetBufferValue recupera un valore di matrice byte (tipo VT_VECTOR | VT_UI1) specificato da una chiave.

Sintassi

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

chiave [in]: Chiave REFPROPERTYKEY che specifica l'elemento da recuperare.
ppValue [out]: Puntatore al valore BYTE* recuperato. Il chiamante è responsabile della liberazione della memoria chiamando CoTaskMemFree.
pcbValue [out]: Puntatore alle dimensioni di ppValue, in byte.

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
DISP_E_TYPEMISMATCH	La proprietà specificata dalla chiave non è un tipo BYTE*.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	La proprietà specificata dalla chiave non è nella raccolta.

Il recupero di un buffer NULL o di un buffer di dimensioni zero non è supportato.

Requisito	Valore
Intestazione	PortableDeviceTypes.h
Libreria	PortableDeviceGUIDs.lib