FreePropVariantArray 函数 (propidl.h)

  • 项目

释放 PROPVARIANT 结构数组使用的内存和引用。

语法

HRESULT FreePropVariantArray(
  [in]      ULONG       cVariants,
  [in, out] PROPVARIANT *rgvars
);

参数

[in] cVariants

类型： ULONG

rgvars 指定的数组中的元素数。

[in, out] rgvars

类型： PROPVARIANT*

要释放的 PROPVARIANT 结构的数组。 当此函数成功返回时，数组中的 PROPVARIANT 结构将被归零，其类型设置为VT_EMPTY。

返回值

类型： HRESULT

如果此函数成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

此函数在将结构设置为零之前释放数组中每个结构保留的内存和引用。

此函数执行与 ClearPropVariantArray 相同的操作，但返回 HRESULT。

示例

以下示例将作为较大程序的一部分包含，演示如何使用 FreePropVariantArray

// PROPVARIANT rgpropvar[5];
// Assume all 5 propvariants are initialized and valid.

FreePropVariantArray(ARRAYSIZE(rgpropvar), rgpropvar);

要求

要求 值
最低受支持的客户端 Windows XP SP2，Windows Vista [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2003 SP1 [桌面应用 |UWP 应用]
目标平台 Windows
标头 propidl.h
Library Ole32.lib
DLL Ole32.dll (版本 6.0 或更高版本)
可再发行组件 Windows 桌面搜索 (WDS) 3.0