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