System.VarUtils.SafeArrayCopy
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 に設定されます。