propVariantClear 函式 (combaseapi.h)
PropVariantClear函式會釋放可在指定PROPVARIANT結構中釋放的所有元素。 對於具有已知專案指標的複雜專案，基礎元素會在釋放包含元素之前釋放。
語法
HRESULT PropVariantClear(
[in] PROPVARIANT *pvar
);
參數
[in] pvar
要釋放任何可解除配置專案的已初始化 PROPVARIANT 結構的指標。 傳回時，所有零都會寫入 PROPVARIANT 結構。
傳回值
此函式會傳回 HRESULT。
備註
在任何間接層級上，都會忽略 Null 指標。 例如，pvar參數會指向類型為 VT_CF的PROPVARIANT結構。 PROPVARIANT結構的pclipdata成員會指向CLIPDATA結構。 CLIPDATA結構中的pClipData指標為Null。 在此範例中， 會忽略 pClipData 指標。 不過，會釋放 PROPVARIANT結構之 pclipdata成員所指向的CLIPDATA結構。
傳回時，此函式會將零寫入指定的 PROPVARIANT 結構，因此 VT 類型 會VT_EMPTY。
將 Null 當做 pvar 參數傳遞會產生S_OK的傳回碼。
注意 請勿使用此函式來初始化 PROPVARIANT 結構。 請改用 PropVariantInit 宏初始化這些結構， (在 Propidl.h) 中定義。
規格需求
| 最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | combaseapi.h |
| 程式庫 | Ole32.lib |
| Dll | Ole32.dll |