IPortableDeviceValues::SetIPortableDeviceKeyCollectionValue-Methode

Die SetIPortableDeviceKeyCollectionValue-Methode fügt einen neuen SetIPortableDeviceKeyCollectionValue-Wert (Typ VT_UNKNOWN) hinzu oder überschreibt einen vorhandenen Wert.

Syntax

HRESULT SetIPortableDeviceKeyCollectionValue(
  [in] REFPROPERTYKEY               key,
  [in] IPortableDeviceKeyCollection *pValue
);

Parameter

key [in]

Ein REFPROPERTYKEY , der das zu erstellende oder überschreibende Element angibt.

pValue [in]

Zeiger auf eine IPortableDeviceKeyCollection-Schnittstelle , die den neuen Wert angibt. Das SDK kopiert einen Verweis auf die übermittelte Schnittstelle und ruft AddRef auf.

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.

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.

Anforderungen

Anforderung	Wert
Header	PortableDeviceTypes.h
Bibliothek	PortableDeviceGUIDs.lib

Siehe auch

IPortableDeviceValues-Schnittstelle

IPortableDeviceValues::GetIPortableDeviceKeyCollectionValue