System.VarUtils.SafeArrayCopyData
Delphi
function SafeArrayCopyData; external oleaut name 'SafeArrayCopyData';
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
function | external public | System.VarUtils.pas | System.VarUtils | System.VarUtils |
Beschreibung
Kopiert die Daten eines sicheren Arrays in ein anderes.
Mit SafeArrayCopyData kopieren Sie die Daten aus dem in SourceArray angegebenen sicheren Arrays in das in TargetArray gespeicherten sicheren Array.
Zum Kopieren der Daten des sicheren Arrays überprüft SafeArrayCopyData zuerst, ob das Quell-Array gültig ist und ob das Quell- und das Ziel-Array kompatibel sind. SafeArrayCopyData sperrt dann das Quell-Array, bereinigt die Daten im Ziel-Array und kopiert die Daten aus dem Quell-Array. Zum Schluss wird das Quell-Array entsperrt.
Wenn SafeArrayCopyData die Daten des Quell-Arrays erfolgreich kopieren konnte, enthält TargetArray die kopierten Daten. Wenn die beiden Arrays inkompatibel sind, gibt SafeArrayCopyData einen VAR_INVALIDARG-Wert zurück. Andernfalls wird VAR_OK zurückgegeben.