IPortableDeviceValues::GetBufferValue-Methode

Die GetBufferValue-Methode ruft einen durch einen Schlüssel angegebenen Bytearraywert (Typ VT _ VECTOR | VT _ UI1) ab.

Syntax

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

Parameter

key [ In]

Ein REFPROPERTYKEY-Schlüssel, der das abzurufende Element angibt.

ppValue [ out]

Zeiger auf den abgerufenen * BYTE_-Wert. Der Aufrufer ist für die Freigabe des Arbeitsspeichers durch Aufrufen von _ CoTaskMemFree verantwortlich.

pwValue [ out]

Zeiger auf die Größe von ppValue in Bytes.

Rückgabewert

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 vom Schlüssel angegebene Eigenschaft ist kein * BYTE-Typ.
HRESULT _ AUS _ WIN32 (FEHLER _ NICHT _ GEFUNDEN)
Die vom Schlüssel angegebene Eigenschaft befindet sich nicht in der Auflistung.

Hinweise

Das Abrufen eines NULL-Puffers oder eines Puffers mit einer Größe von null wird nicht unterstützt.

Anforderungen

Anforderung Wert
Header
PortableDeviceTypes.h
Bibliothek
PortableDeviceGUIDs.lib

Weitere Informationen

IPortableDeviceValues-Schnittstelle

IPortableDeviceValues::SetBufferValue