IPortableDevicePropVariantCollection::Add-Methode

Die Add-Methode fügt der Auflistung ein Element hinzu.

Syntax

HRESULT Add(
  [in] const PROPVARIANT *pValue
);

Parameter

pValue [in]

Zeiger auf ein neues PROPVARIANT-Objekt , das der Auflistung hinzugefügt werden soll. Diese Methode kopiert propVARIANT in die Auflistung, sodass Sie Ihre lokale Kopie der Variablen freigeben sollten, indem Sie PropVariantClear nach dem Aufrufen dieser Methode aufrufen.

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 VARTYPE für pValue VT_VECTOR oder VT_UI1 ist, wird das Festlegen und Abrufen eines Null - oder Null-Puffers nicht unterstützt. Beispielsweise sind weder pValue.caub.pElems = NULL noch pValue.caub.cElems = 0 zulässig.

Wenn ein Aufrufer versucht, ein Element eines anderen vartype hinzuzufügen, der in der Auflistung enthalten ist und der PROPVARIANT-Wert von dieser Schnittstelle nicht automatisch geändert werden kann, schlägt diese Methode fehl. Um den Auflistungstyp manuell zu ändern, rufen Sie IPortableDevicePropVariantCollection::ChangeType auf.

Beispiele

Ein Beispiel für die Verwendung dieser Methode finden Sie unter Abrufen eines Objektbezeichners aus einem persistenten eindeutigen Bezeichner.

Anforderungen

Anforderung	Wert
Header	PortableDeviceTypes.h
Bibliothek	PortableDeviceGUIDs.lib

Siehe auch

IPortableDevicePropVariantCollection-Schnittstelle

Verschieben von Inhalten auf dem Gerät

Abrufen eines Objektbezeichners aus einem persistenten eindeutigen Bezeichner