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, daher sollten Sie Ihre lokale Kopie der Variablen freigeben, indem Sie PropVariantClear aufrufen, nachdem Sie diese Methode aufgerufen haben.

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 Puffers mit NULL- oder Nullgröße 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, das in der Auflistung enthalten ist, und der PROPVARIANT-Wert nicht automatisch von dieser Schnittstelle geändert werden kann, schlägt diese Methode fehl. Um den Sammlungstyp 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.

Requirements (Anforderungen)

Anforderung Wert
Header
PortableDeviceTypes.h
Bibliothek
PortableDeviceGUIDs.lib

Weitere Informationen

IPortableDevicePropVariantCollection-Schnittstelle

Verschieben von Inhalten auf dem Gerät

Abrufen eines Objektbezeichners aus einem persistenten eindeutigen Bezeichner