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