Metodo IPortableDevicePropVariantCollection::Add
Il metodo Add aggiunge un elemento all'insieme.
Sintassi
HRESULT Add(
[in] const PROPVARIANT *pValue
);
Parametri
-
pValue [in]
-
Puntatore a un nuovo oggetto PROPVARIANT da aggiungere all'insieme. Questo metodo copia PROPVARIANT nell'insieme, quindi è necessario rilasciare la copia locale della variabile chiamando PropVariantClear dopo aver chiamato questo metodo.
Valore restituito
Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.
| Codice restituito | Descrizione |
|---|---|
|
Il metodo è riuscito. |
Commenti
Quando varTYPE per pValue è VT_VECTOR o VT_UI1, l'impostazione e il recupero di un buffer NULL o di dimensioni zero non è supportato. Ad esempio, non sono consentiti pValue.caub.pElems = NULL né pValue.caub.cElems = 0.
Se un chiamante tenta di aggiungere un elemento di un varTYPE diverso contenuto nella raccolta e il valore PROPVARIANT non può essere modificato automaticamente da questa interfaccia, questo metodo avrà esito negativo. Per modificare manualmente il tipo di raccolta, chiama IPortableDevicePropVariantCollection::ChangeType.
Esempio
Per un esempio di come usare questo metodo, vedere Recupero di un identificatore di oggetto da un identificatore univoco persistente
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
| Libreria |
|