System.VarUtils.SafeArrayCreate

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function SafeArrayCreate(VarType, DimCount: Integer; const Bounds: TVarArrayBoundArray): PVarArray;
Bounds: PVarArrayBoundArray): PVarArray; external oleaut name 'SafeArrayCreate';

Eigenschaften

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

Beschreibung

Erstellt ein sicheres Array.

Mit SafeArrayCreate erstellen Sie ein sicheres Array mit den angegebenen Parametern.

Der Parameter VarType gibt den Typ der Elemente in dem sicheren Array an. Mit den Konstanten var... (varInteger, varBoolean, varDate, varCurrency usw.) aus der Unit System können Sie den Variant-Typ der Elemente festlegen.

Der Parameter DimCount gibt die Anzahl der Dimensionen des sicheren Arrays an. DimCount repräsentiert auch die anzahl der Elemente in dem Bounds-Konstanten-Array.

Bounds ist ein konstanter TVarArrayBoundArray-Typ, der die Größeninformation für alle Dimensionen eines sicheren Arrays angibt.

Um ein sicheres Array zu erstellen, überprüft SafeArrayCreate zunächst, ob der Elementtyp gültig ist, und weist dann mit der Funktion SafeArrayAllocDescriptor Speicher für den sicheren Array-Deskriptor zu. Zum Schluss wird mit SafeArrayAllocData der Speicher für die eigentlichen Daten des sicheren Arrays zugewiesen. Ist dies nicht erfolgreich, wird der zuvor mit der Routine SafeArrayDestroyDescriptor zugewiesene Deskriptor freigegeben.

Wenn SafeArrayCreate das sichere Array erstellen konnte, wird ein Zeiger auf das Array als eine PVarArray-Typvariable zurückgegeben. Wenn SafeArrayCreate das sichere Array nicht erstellen konnte, wird nil zurückgegeben.

Verwenden Sie zum Freigeben des sicheren Arrays die Funktion SafeArrayDestroy.

Siehe auch

Codebeispiele