PropVariantClear-Funktion (combaseapi.h)

Die PropVariantClear-Funktion gibt alle Elemente frei, die in einer bestimmten PROPVARIANT-Struktur freigegeben werden können. Bei komplexen Elementen mit bekannten Elementzeigern werden die zugrunde liegenden Elemente vor dem Freigeben des enthaltenden Elements freigegeben.

Syntax

HRESULT PropVariantClear(
  [in] PROPVARIANT *pvar
);

Parameter

[in] pvar

Ein Zeiger auf eine initialisierte PROPVARIANT-Struktur , für die alle delegierbaren Elemente freigegeben werden sollen. Bei der Rückgabe werden alle Nullen in die PROPVARIANT-Struktur geschrieben.

Rückgabewert

Diese Funktion gibt HRESULT zurück.

Hinweise

Auf jeder Dereferenzierungsebene werden NULL-Zeiger ignoriert. Der pvar-Parameter verweist beispielsweise auf eine PROPVARIANT-Struktur vom Typ VT_CF. Das pclipdata-Element der PROPVARIANT-Struktur zeigt auf eine CLIPDATA-Struktur . Der pClipData-Zeiger in der CLIPDATA-Struktur ist NULL. In diesem Beispiel wird der pClipData-Zeiger ignoriert. Die CLIPDATA-Struktur , auf die vom pclipdata-Element der PROPVARIANT-Struktur verwiesen wird, wird jedoch freigegeben.

Bei der Rückgabe schreibt diese Funktion Nullen in die angegebene PROPVARIANT-Struktur , sodass der VT-Typ VT_EMPTY ist.

Das Übergeben von NULL als pvar-Parameter erzeugt einen Rückgabecode von S_OK.

Anforderungen

Weitere Informationen

FreePropVariantArray