System.Win.ComObj.CreateOleObject

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function CreateOleObject(const ClassName: string): IDispatch;

C++

extern DELPHI_PACKAGE _di_IDispatch __fastcall CreateOleObject(const System::UnicodeString ClassName);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.Win.ComObj.pas
System.Win.ComObj.hpp
System.Win.ComObj System.Win.ComObj

Beschreibung

Instantiiert ein Automatisierungsobjekt.

CreateOleObject erzeugt ein einzelnes, nicht initialisiertes Objekt der mit dem Parameter ClassName angegebenen Klasse. ClassName enthält den der Klassen-ID (CLSID) entsprechenden String. Mit CreateOleObject lässt sich ein Objekt des angegebenen Typs erstellen, wenn die CLSID bekannt ist und sich das Objekt auf einem lokalen oder In-Process-Server befindet. Mit CreateOleObject werden nur Objekte erzeugt, die nicht Bestandteil eines Aggregats sind.

Anmerkung:  CreateOleObject wird einmal für jede neue Instanz einer Klasse aufgerufen. Um mehrere Instanzen einer Klasse zu erzeugen, verwenden Sie einen Klassengenerator.

CreateOleObject gibt eine Referenz auf die Schnittstelle zurück, die für die Kommunikation mit dem Objekt verwendet wird. Bei CreateOleObject ist diese Schnittstelle vom Typ IDispatch. Um ein COM-Objekt zu erstellen, das keine IDispatch-Schnittstelle unterstützt, verwenden Sie CreateComObject.

Tip:  Wenn die von CreateOleObject zurückgegebene Schnittstelle einer Varianten zugewiesen wird, können Sie die Schnittstelle freigeben, indem Sie die Konstante Unassigned dieser Varianten zuweisen.

Siehe auch