System.VarUtils.SafeArrayCopy

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

Delphi

function SafeArrayCopy; external oleaut name 'SafeArrayCopy';

C++

extern "C" HRESULT __stdcall SafeArrayCopy(System::PVarArray SourceArray, /* out */ System::PVarArray &TargetArray);

プロパティ

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

説明

セーフ配列を別のセーフ配列にコピーします。

SourceArray で与えられたセーフ配列を、TargetArray に格納されるセーフ配列にコピーするには、SafeArrayCopy を使用します。

セーフ配列をコピーするために、SafeArrayCopy は、まずソース配列が有効かどうかを確認します。次に、SafeArrayCopy はソース配列をロックし、記述子用のメモリと、ターゲット配列の実データ用のメモリを割り当てて、ソース配列からターゲット配列にデータをコピーします。最後に、ソース配列をロック解除します。

SafeArrayCopy がソース配列のコピーに成功した場合、TargetArray にはコピーされた配列が含まれます。SafeArrayCopy がセーフ配列のコピーに失敗した場合は、TargetArray パラメータは単に nil に設定されます。

関連項目