IPortableDeviceValues::SetBufferValue-Methode
Die SetBufferValue-Methode fügt einen neuen BYTE*-Wert hinzu (Typ VT_VECTOR | VT_UI1) oder überschreibt eine vorhandene.
Syntax
HRESULT SetBufferValue(
[in] REFPROPERTYKEY key,
[in] BYTE *pValue,
[in] DWORD cbValue
);
Parameter
-
key [in]
-
Ein REFPROPERTYKEY , der das zu erstellende oder überschreibende Element angibt.
-
pValue [in]
-
Ein BYTE* , das die Daten enthält, die in das Element geschrieben werden sollen. Die übermittelten Pufferdaten werden in die Schnittstelle kopiert, sodass der Aufrufer diesen Puffer nach diesem Aufruf freigeben kann.
-
cbValue [in]
-
Die Größe des Werts, auf den pValue in Bytes verweist.
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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
Bemerkungen
Wenn ein vorhandener Wert denselben Schlüssel aufweist, der durch den Schlüsselparameter angegeben wird, überschreibt er den vorhandenen Wert ohne Warnung. Der vorhandene Schlüsselspeicher wird entsprechend freigegeben.
Das Festlegen eines NULL - oder Null-Puffers wird nicht unterstützt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|