IPortableDeviceValues::GetBufferValue-Methode

Die GetBufferValue-Methode ruft einen Bytearraywert (Typ VT_VECTOR | VT_UI1) durch einen Schlüssel angegeben.

Syntax

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

Key [in]: Ein REFPROPERTYKEY-Schlüssel , der das abzurufende Element angibt.
ppValue [out]: Zeiger auf den abgerufenen BYTE* -Wert. Der Aufrufer ist dafür verantwortlich, den Arbeitsspeicher durch Aufrufen von CoTaskMemFree freizugeben.
pcbValue [out]: Zeiger auf die Größe von ppValue in Bytes.

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
DISP_E_TYPEMISMATCH	Die durch key angegebene Eigenschaft ist kein BYTE*-Typ.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Die durch key angegebene Eigenschaft ist nicht in der Auflistung enthalten.

Das Abrufen eines NULL-Puffers oder eines Puffers mit Nullgröße wird nicht unterstützt.

Anforderung	Wert
Header	PortableDeviceTypes.h
Bibliothek	PortableDeviceGUIDs.lib