System.VarUtils.SafeArrayDestroy

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function SafeArrayDestroy; external oleaut name 'SafeArrayDestroy';

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function external public System.VarUtils.pas System.VarUtils System.VarUtils

Beschreibung

Gibt ein sicheres Array frei.

Mit SafeArrayDestroy geben Sie das in VarArray angegebene sichere Array frei.

SafeArrayDestroy überprüft zunächst, ob das angegebene sichere Array gesperrt oder nil ist. In diesem Fall gibt SafeArrayDestroy VAR_ARRAYISLOCKED bzw. VAR_INVALIDARG zurück.

Wenn das sichere Array gültig ist, entfernt SafeArrayDestroy die eigentlichen Daten mit der Routine SafeArrayDestroyData aus dem Arbeitsspeicher und gibt auch den zugehörigen sicheren Array-Deskriptor mit der Routine SafeArrayDestroyDescriptor frei. Wenn SafeArrayDestroy das sichere Array freigeben konnte, wird das Ergebnis VAR_OK zurückgegeben.

Siehe auch