Metodo IPortableDevicePropVariantCollection::Add (portabledevicetypes.h)

Aggiunge un elemento alla raccolta.

Sintassi

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

Parametri

[in] pValue

Puntatore a un nuovo oggetto PROPVARIANT da aggiungere all'insieme. Questo metodo copia PROPVARIANT nell'insieme. È possibile 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
S_OK	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.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	portabledevicetypes.h

Vedi anche

Interfaccia IPortableDevicePropVariantCollection