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 结构。 相反，请使用 Propidl.h) 中定义的 PropVariantInit 宏 (初始化这些结构。
要求
| 最低受支持的客户端 | Windows 2000 专业版 [桌面应用 |UWP 应用] |
| 最低受支持的服务器 | Windows 2000 Server [桌面应用 |UWP 应用] |
| 目标平台 | Windows |
| 标头 | combaseapi.h |
| Library | Ole32.lib |
| DLL | Ole32.dll |