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

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau | Applications UWP]
Plateforme cible	Windows
En-tête	combaseapi.h
Bibliothèque	Ole32.lib
DLL	Ole32.dll

Voir aussi

PropVariantClear