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));
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows XP SP2、Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 SP1 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | propvarutil.h |
| Library | Propsys.lib |
| DLL | Propsys.dll (6.0 或更高版本) |
| 可再发行组件 | Windows 桌面搜索 (WDS) 3.0 |