Funzione FreePropVariantArray (propidl.h)

Articolo
03/05/2024

Libera la memoria e i riferimenti utilizzati da una matrice di strutture PROPVARIANT .

Sintassi

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

Parametri

[in] cVariants

Tipo: ULONG

Numero di elementi nella matrice specificata da rgvars.

[in, out] rgvars

Tipo: PROPVARIANT*

Matrice di strutture PROPVARIANT da liberare. Quando questa funzione viene restituita correttamente, le strutture PROPVARIANT nella matrice vengono azzerato e il relativo tipo viene impostato su VT_EMPTY.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

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 ClearPropVariantArray, ma restituisce un valore HRESULT.

Esempio

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

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

FreePropVariantArray(ARRAYSIZE(rgpropvar), rgpropvar);

Requisiti

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

Condividi tramite