通过

freePropVariantArray 函数 (combaseapi.h)

  • 项目

FreePropVariantArray 函数对 rgvars 数组中的每个 PROPVARIANT 结构调用 PropVariantClear，使数组的每个成员的值为零。

语法

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

参数

[in] cVariants

PROPVARIANT 数组中的元素计数 (rgvars) 。

[in] rgvars

指向要为其释放任何可解除处理的元素的 PROPVARIANT 结构的初始化数组的指针。 退出时，所有零都写入 PROPVARIANT 结构 (因此将它们标记为VT_EMPTY) 。

返回值

此函数返回 HRESULT。

注解

FreePropVariantArray 对 PROPVARIANT 结构数组调用 PropVariantClear 以清除所有有效成员。 释放所有有效的 PROPVARIANT 结构。 如果任何 PROPVARIANT 结构包含非法 VT 类型，则释放有效成员，并且函数返回STG_E_INVALIDPARAMETER。

为 rgvars 传递 NULL 是合法的，并生成S_OK的返回代码。

要求

要求 值
最低受支持的客户端 Windows 2000 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
目标平台 Windows
标头 combaseapi.h
Library Ole32.lib
DLL Ole32.dll

另请参阅

PropVariantClear