System.VarUtils.SafeArrayDestroy

提供: RAD Studio API Documentation
移動先: 案内検索

Delphi

function SafeArrayDestroy; external oleaut name 'SafeArrayDestroy';

プロパティ

種類 可視性 ソース ユニット
function external public System.VarUtils.pas System.VarUtils System.VarUtils

説明

セーフ配列を破棄します。

VarArray で与えられたセーフ配列を破棄するには、SafeArrayDestroy を使用します。

SafeArrayDestroy は、まず、与えられたセーフ配列がロックされているか、または nil かどうかを確認します。これに該当する場合、SafeArrayDestroy は、VAR_ARRAYISLOCKED または VAR_INVALIDARG をそれぞれ返します。

セーフ配列が有効な場合、SafeArrayDestroy は、SafeArrayDestroyData を呼び出して実データをメモリから削除し、SafeArrayDestroyDescriptor を呼び出してそれに関連付けられているセーフ配列記述子を破棄します。SafeArrayDestroy がセーフ配列の破棄に成功した場合は、VAR_OK を返します。

関連項目