Metodo IPortableDeviceValues::GetBufferValue (portabledevicetypes.h)

L'interfaccia GetBufferValue recupera un valore di matrice di byte (tipo VT_VECTOR o VT_UI1) specificato da una chiave.

Sintassi

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

[in] key

Chiave REFPROPERTYKEY che specifica l'elemento da recuperare.

[out] ppValue

Puntatore al valore BYTE* recuperato. Il chiamante deve liberare la memoria chiamando CoTaskMemFree.

[out] pcbValue

Puntatore alla dimensione di ppValue, in byte.

Il metodo restituisce un valore HRESULT. I valori restituiti possibili sono illustrati 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 è presente nell'insieme.
E_INVALIDARG	Uno o più argomenti specificati non sono validi.

Il recupero di un buffer NULL o di un buffer di dimensioni zero non è supportato e restituirà E_INVALIDARG.

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	portabledevicetypes.h