Funzione FreePropVariantArray (combaseapi.h)

La funzione FreePropVariantArray chiama PropVariantClear in ognuna delle strutture PROPVARIANT della matrice rgvars per rendere il valore zero per ognuno dei membri della matrice.

Sintassi

HRESULT FreePropVariantArray(
  [in] ULONG       cVariants,
  [in] PROPVARIANT *rgvars
);

Parametri

[in] cVariants

Numero di elementi nella matrice PROPVARIANT (rgvars).

[in] rgvars

Puntatore a una matrice inizializzata di strutture PROPVARIANT per cui tutti gli elementi deallocabili devono essere liberati. All'uscita, tutti gli zero vengono scritti nella struttura PROPVARIANT (contrassegnandoli come VT_EMPTY).

Valore restituito

Questa funzione restituisce HRESULT.

Commenti

FreePropVariantArray chiama PropVariantClear in una matrice di strutture PROPVARIANT per cancellare tutti i membri validi. Tutte le strutture PROPVARIANT valide vengono liberate. Se una delle strutture PROPVARIANT contiene tipi VT illegali, i membri validi vengono liberati e la funzione restituisce STG_E_INVALIDPARAMETER.

Il passaggio di NULL per rgvars è legale e produce un codice restituito di S_OK.

Requisiti

Vedi anche

PropVariantClear