Fonction FreePropVariantArray (combaseapi.h)

La fonction FreePropVariantArray appelle PropVariantClear sur chacune des structures PROPVARIANT du tableau rgvars pour obtenir la valeur zéro pour chacun des membres du tableau.

Syntaxe

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

Paramètres

[in] cVariants

Nombre d’éléments dans le tableau PROPVARIANT (rgvars).

[in] rgvars

Pointeur vers un tableau initialisé de structures PROPVARIANT pour lesquelles tous les éléments pouvant être supprimés doivent être libérés. À la sortie, tous les zéros sont écrits dans la structure PROPVARIANT (ce qui les étiquette comme VT_EMPTY).

Valeur retournée

Cette fonction retourne HRESULT.

Remarques

FreePropVariantArray appelle PropVariantClear sur un tableau de structures PROPVARIANT pour effacer tous les membres valides. Toutes les structures PROPVARIANT valides sont libérées. Si l’une des structures PROPVARIANT contient des types VT non conformes, les membres valides sont libérés et la fonction retourne STG_E_INVALIDPARAMETER.

Le passage de la valeur NULL pour les rgvars est légal et produit un code de retour de S_OK.

Configuration requise

Voir aussi

PropVariantClear