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
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [app desktop | App UWP] |
| Server minimo supportato | Windows 2000 Server [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | combaseapi.h |
| Libreria | Ole32.lib |
| DLL | Ole32.dll |