Condividi tramite

Funzione ClearPropVariantArray (propvarutil.h)

  • Articolo

Libera la memoria e i riferimenti usati da una matrice di strutture PROPVARIANT archiviate in una matrice.

Sintassi

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

Parametri

[in] rgPropVar

Tipo: PROPVARIANT*

Matrice di strutture PROPVARIANT da liberare.

[in] cVars

Tipo: UINT

Numero di elementi nella matrice specificata da rgPropVar.

Valore restituito

Nessun valore restituito.

Commenti

Questa funzione rilascia la memoria e i riferimenti contenuti in ogni struttura nella matrice prima di impostare le strutture su zero.

Questa funzione esegue la stessa azione di FreePropVariantArray, ma FreePropVariantArray restituisce un valore HRESULT.

Esempio

L'esempio seguente, da includere come parte di un programma più ampio, illustra come usare ClearPropVariantArray

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

ClearPropVariantArray(rgpropvar, ARRAYSIZE(rgpropvar));

Requisiti

Requisito Valore
Client minimo supportato Windows XP con SP2, Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2003 con SP1 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione propvarutil.h
Libreria Propsys.lib
DLL Propsys.dll (versione 6.0 o successiva)
Componente ridistribuibile Windows Desktop Search (WDS) 3.0

Vedi anche

ClearVariantArray