Partager via

Fonction ClearPropVariantArray (propvarutil.h)

  • Article

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
);

Paramètres

[in] rgPropVar

Type : PROPVARIANT*

Tableau de structures PROPVARIANT à libérer.

[in] cVars

Type : UINT

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

Valeur retournée

Pas de valeur de retour.

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

Exemples

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));

Configuration requise

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

Voir aussi

ClearVariantArray