通过

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

另请参阅

FreePropVariantArray