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 |