SafeArrayDestroyData 函数 (oleauto.h)

  • 项目

销毁指定安全数组中的所有数据。

语法

HRESULT SafeArrayDestroyData(
  [in] SAFEARRAY *psa
);

参数

[in] psa

安全数组描述符。

返回值

此函数可以返回其中一个值。

返回代码 说明
S_OK
 成功。
E_INVALIDARG
 参数 psa 无效。
DISP_E_ARRAYISLOCKED
 数组已锁定。

注解

释放包含非变体数据类型的元素的安全数组时，通常使用此函数。 如果对象存储在数组中，则会对数组中的每个对象调用 Release。 variant 的安全数组将在每个成员上调用 VariantClear 函数，而 BSTR 的安全数组将在每个元素上具有调用 的 SysFreeString 函数。 将调用 IRecordInfo：：RecordClear 以释放记录的对象引用和记录的其他值，而无需解除分配记录。

要求

要求 值
目标平台 Windows
标头 oleauto.h
Library OleAut32.lib
DLL OleAut32.dll