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 |
|---|---|
|
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 |
|
| Bibliothek |
|