System.VarUtils.SafeArrayCopyData
Delphi
function SafeArrayCopyData; external oleaut name 'SafeArrayCopyData';
C++
extern "C" HRESULT __stdcall SafeArrayCopyData(System::PVarArray SourceArray, System::PVarArray TargetArray);
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
| function | external public | System.VarUtils.pas System.VarUtils.hpp |
System.VarUtils | System.VarUtils |
説明
セーフ配列のデータを別のセーフ配列にコピーします。
SourceArray で与えられたセーフ配列のデータを、TargetArray に格納されるセーフ配列にコピーするには、SafeArrayCopyData を使用します。
セーフ配列のデータをコピーするために、SafeArrayCopyData は、まずソース配列が有効かどうかを確認し、ソース配列とターゲット配列の互換性を確認します。次に、SafeArrayCopyData はソース配列をロックし、ターゲット配列内のデータをクリアします。そして、ソース配列のデータをコピーします。最後に、ソース配列をロック解除します。
SafeArrayCopyData がソース配列からのデータのコピーに成功した場合、TargetArray にはコピーされたデータが含まれます。2 つの配列に互換性がない場合、SafeArrayCopyData は VAR_INVALIDARG を返します。それ以外の場合は、VAR_OK を返します。