Fonction FreePropVariantArray (propidl.h)

Libère la mémoire et les références utilisées par un tableau de structures PROPVARIANT .

Syntaxe

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

Paramètres

[in] cVariants

Type : ULONG

Nombre d’éléments dans le tableau spécifié par rgvars.

[in, out] rgvars

Type : PROPVARIANT*

Tableau de structures PROPVARIANT à libérer. Lorsque cette fonction retourne correctement, les structures PROPVARIANT du tableau sont mises à zéro et leur type est défini sur VT_EMPTY.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Cette fonction libère la mémoire et les références détenues par chaque structure du tableau avant de définir les structures sur zéro.

Cette fonction effectue la même action que ClearPropVariantArray, mais retourne un HRESULT.

Exemples

L’exemple suivant, à inclure dans un programme plus grand, montre comment utiliser FreePropVariantArray

// PROPVARIANT rgpropvar[5];
// Assume all 5 propvariants are initialized and valid.

FreePropVariantArray(ARRAYSIZE(rgpropvar), rgpropvar);

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP avec SP2, Windows Vista [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows Server 2003 avec SP1 [applications de bureau | Applications UWP]
Plateforme cible	Windows
En-tête	propidl.h
Bibliothèque	Ole32.lib
DLL	Ole32.dll (version 6.0 ou ultérieure)
Composant redistribuable	Windows Desktop Search (WDS) 3.0