CREATE OBJECT

CREATE OBJECT operand1 OF [CLASS] operand2
   [GIVING operand4]

Dieses Dokument behandelt folgende Themen:

Eine Erläuterung der in dem Syntax-Diagramm verwendeten Symbole entnehmen Sie dem Abschnitt Syntax-Symbole.

Verwandte Statements: DEFINE CLASS | INTERFACE | METHOD | PROPERTY | SEND METHOD

Gehört zur Funktionsgruppe: Komponenten-basierte Anwendungen erstellen

Funktion

Das Statement CREATE OBJECT dient zum Erstellen einer Instanz einer Klasse.

Syntax-Beschreibung

Operanden-Definitionstabelle:

Operand Mögliche Struktur Mögliche Formate Referenzierung erlaubt Dynam. Definition
operand1   S                               O nein nein
operand2 C S       A                         ja nein
operand4   S     N         I                 ja nein

Syntax-Element-Beschreibung:

Syntax-Element Beschreibung
operand1
Objekt-Handle:

operand1 muss als Objekt-Handle (HANDLE OF OBJECT) definiert sein. Die Objekt-Handle wird gefüllt, wenn das Objekt erfolgreich erstellt wurde. Wenn operand1 nicht erfolgreich zurückgegeben wird, enthält er den Wert NULL-HANDLE.

OF CLASS operand2
Klassen-Name:

operand2 ist der Name der Klasse, für die das Objekt erstellt werden soll. Bei Klassen, die nicht als DCOM-Klassen registriert sind, muss er den im DEFINE CLASS-Statement definierten Klassen-Namen enthalten. Bei Klassen, die registriert sind, muss er entweder die ProgID der Klasse oder die Klasse GUID enthalten. Bei als DCOM registrierten Natural-Klassen entspricht die ProgID dem im DEFINE CLASS-Statement angegebenen Klassen-Namen. 

CREATE OBJECT #O1 OF CLASS "Employee" or
CREATE OBJECT #O1 OF CLASS "653BCFE0-84DA-11D0-BEB3-10005A66D231"
GIVING operand4
GIVING-Klausel:

Wenn die GIVING-Klausel angegeben wird, enthält operand4 entweder die Natural-Meldungsnummer, falls ein Fehler auftritt, oder Null bei fehlerfreier Ausführung.

Wenn die GIVING-Klausel nicht angegeben wird, wird die Natural-Laufzeitfehlerverarbeitung ausgelöst, falls ein Fehler auftritt.