ClearPropVariantArray-Funktion (propvarutil.h)
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 |