ClearPropVariantArray 函数 (propvarutil.h)

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

语法

PSSTDAPI_(void) ClearPropVariantArray(
  [in] PROPVARIANT *rgPropVar,
  [in] UINT        cVars
);

参数

[in] rgPropVar

类型： PROPVARIANT*

要释放的 PROPVARIANT 结构的数组。

[in] cVars

类型： UINT

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

返回值

没有返回值。

注解

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

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

示例

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

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

ClearPropVariantArray(rgpropvar, ARRAYSIZE(rgpropvar));

要求

另请参阅

ClearVariantArray