System.Variant.CreateObject
C++
static Variant CreateObject(const String& ProgID);
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | sysvari.h | System | Variant |
Beschreibung
Erzeugt ein OLE-Automatisierungsobjekt mit dem in ProgID angegebenen Programmbezeichner und gibt es als Variant-Objekt zurück.
CreateObject erzeugt ein nicht initialisiertes Objekt der angegebenen Klasse. Mit CreateObject kann ein Objekt eines bestimmten Typs erzeugt werden, wenn die ProgID bekannt ist und sich das Objekt in einem lokalen oder prozessinternen Server befindet. Mit CreateObject werden nur Objekte erzeugt, die nicht Bestandteil eines Aggregats sind.
CreateObject wird einmal aufgerufen, um eine neue Instanz einer Klasse zu erzeugen. Sollen mehrere Instanzen derselben Klasse erzeugt werden, sollte stattdessen ein Klassengenerator verwendet werden.
CreateObject gibt eine Referenz auf den Bezeichner der Schnittstelle zurück, die zur Kommunikation mit dem Objekt verwendet wird. Bei CreateObject ist diese Schnittstelle vom Typ IDispatch.
Ist der Parameter ProgID ungültig, löst CreateObject eine EOleSysError-Exception aus.