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