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

Weitere Informationen

ClearVariantArray