ClearPropVariantArray-Funktion (propvarutil.h)

  • Artikel

Gibt den Arbeitsspeicher und die Verweise frei, die von einem Array von PROPVARIANT-Strukturen verwendet werden, die in einem Array gespeichert sind.

Syntax

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

Parameter

[in] rgPropVar

Typ: PROPVARIANT*

Array von PROPVARIANT-Strukturen , die frei werden sollen.

[in] cVars

Typ: UINT

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

Rückgabewert

Kein Rückgabewert.

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 FreePropVariantArray aus, aber FreePropVariantArray gibt ein HRESULT zurück.

Beispiele

Das folgende Beispiel, das als Teil eines größeren Programms enthalten sein soll, veranschaulicht die Verwendung von ClearPropVariantArray.

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

ClearPropVariantArray(rgpropvar, ARRAYSIZE(rgpropvar));

Anforderungen

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

Weitere Informationen

ClearVariantArray