FreePropVariantArray-Funktion (combaseapi.h)

Die FreePropVariantArray-Funktion ruft PropVariantClear für jede der PROPVARIANT-Strukturen im rgvars-Array auf, um den Wert null für jedes Element des Arrays zu machen.

Syntax

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

Parameter

[in] cVariants

Anzahl der Elemente im PROPVARIANT-Array (rgvars).

[in] rgvars

Zeiger auf ein initialisiertes Array von PROPVARIANT-Strukturen , für das alle delegierbaren Elemente freigegeben werden sollen. Beim Beenden werden alle Nullen in die PROPVARIANT-Struktur geschrieben (daher als VT_EMPTY gekennzeichnet).

Rückgabewert

Diese Funktion gibt HRESULT zurück.

Hinweise

FreePropVariantArray ruft PropVariantClear für ein Array von PROPVARIANT-Strukturen auf, um alle gültigen Member zu löschen. Alle gültigen PROPVARIANT-Strukturen werden freigegeben. Wenn eine der PROPVARIANT-Strukturen unzulässige VT-Typen enthält, werden gültige Member freigegeben, und die Funktion gibt STG_E_INVALIDPARAMETER zurück.

Das Übergeben von NULL für rgvars ist zulässig und erzeugt einen Rückgabecode von S_OK.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	combaseapi.h
Bibliothek	Ole32.lib
DLL	Ole32.dll

Weitere Informationen

PropVariantClear