FreePropVariantArray-Funktion (propidl.h)

Artikel
03/04/2024

Gibt den Von einem Array von PROPVARIANT-Strukturen verwendeten Arbeitsspeicher und Verweise frei.

Syntax

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

Parameter

[in] cVariants

Typ: ULONG

Die Anzahl der Elemente im Array, das von rgvars angegeben wird.

[in, out] rgvars

Typ: PROPVARIANT*

Array von PROPVARIANT-Strukturen , die frei werden sollen. Wenn diese Funktion erfolgreich zurückgibt, werden die PROPVARIANT-Strukturen im Array auf Null gesetzt, und ihr Typ wird auf VT_EMPTY festgelegt.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Funktion gibt den Arbeitsspeicher und die Verweise frei, die von jeder Struktur im Array gespeichert werden, bevor die Strukturen auf 0 festgelegt werden.

Diese Funktion führt dieselbe Aktion wie ClearPropVariantArray aus, gibt jedoch ein HRESULT zurück.

Beispiele

Im folgenden Beispiel, das als Teil eines größeren Programms eingeschlossen werden soll, wird veranschaulicht, wie FreePropVariantArray verwendet wird.

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

FreePropVariantArray(ARRAYSIZE(rgpropvar), rgpropvar);

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2, Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 mit SP1 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	propidl.h
Bibliothek	Ole32.lib
DLL	Ole32.dll (Version 6.0 oder höher)
Verteilbare Komponente	Windows Desktop Search (WDS) 3.0

Freigeben über