System.VarUtils.SafeArrayCopy
Delphi
function SafeArrayCopy; external oleaut name 'SafeArrayCopy';
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | external public | System.VarUtils.pas | System.VarUtils | System.VarUtils |
Beschreibung
Kopiert ein sicheres Array in ein anderes.
Mit SafeArrayCopy erstellen Sie eine Kopie des in SourceArray angegebenen sicheren Arrays im in TargetArray gespeicherten sicheren Array.
Zum Kopieren des sicheren Arrays überprüft SafeArrayCopy zuerst, ob das Quell-Array gültig ist. Dann sperrt SafeArrayCopy das Quell-Array, weist Speicher für den Deskriptor und die Daten des Ziel-Array zu und kopiert die Daten des Quell-Arrays in das Ziel-Array. Zum Schluss wird das Quell-Array entsperrt.
Wenn SafeArrayCopy das Quell-Array erfolgreich kopieren konnte, enthält TargetArray das kopierte Array. Wenn der Kopiervorgang fehlgeschlagen ist, setzt SafeArrayCopy den Parameter TargetArray auf nil.