Fonction ClearPropVariantArray (propvarutil.h)

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

Syntaxe

PSSTDAPI_(void) ClearPropVariantArray(
  [in] PROPVARIANT *rgPropVar,
  [in] UINT        cVars
);

[in] rgPropVar

Tableau de structures PROPVARIANT à libérer.

[in] cVars

Type : UINT

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

Pas de valeur de retour.

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 FreePropVariantArray, mais FreePropVariantArray retourne un HRESULT.

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

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

ClearPropVariantArray(rgpropvar, ARRAYSIZE(rgpropvar));

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