SafeArrayDestroyData 関数 (oleauto.h)
指定したセーフ配列内のすべてのデータを破棄します。
構文
HRESULT SafeArrayDestroyData(
[in] SAFEARRAY *psa
);
パラメーター
[in] psa
安全な配列記述子。
戻り値
この関数は、これらの値のいずれかを返すことができます。
リターン コード | 説明 |
---|---|
|
正常終了しました。 |
|
引数 psa が無効です。 |
|
配列がロックされています。 |
注釈
この関数は通常、バリアント以外のデータ型を持つ要素を含む安全な配列を解放するときに使用されます。 オブジェクトが配列に格納されている場合は、配列内の各オブジェクトに対して Release が呼び出されます。 variant のセーフ配列には、各メンバーで VariantClear 関数が呼び出され、BSTR のセーフ配列には、各要素で SysFreeString 関数が呼び出されます。 IRecordInfo::RecordClear は、レコードの割り当てを解除せずに、オブジェクト参照とレコードの他の値を解放するために呼び出されます。
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | oleauto.h |
Library | OleAut32.lib |
[DLL] | OleAut32.dll |