GetActiveOleObject

Parameter

(const ClassName: String) : IDispatch;

Beschreibung

GetActiveOleObject ruft eine Referenz auf eine IDispatch-Schnittstelle für ein aktuell ausgeführtes, registriertes COM-Objekt ab.GetActiveOleObject gibt eine Referenz auf die IDispatch-Schnittstelle des aktiven Objekts zurück. Die Klasse des Objekts wird im Parameter ClassName angegeben. Es handelt sich dabei um die Programm-ID der Klasse des Objekts, das in der Tabelle der ausgeführten OLE-Objekte aktiv ist. Mit GetActiveOleObject kann auf diese Tabelle zugegriffen werden. Verwenden Sie die API-Funktion RegisterActiveObject, um ein Objekt in diese Tabelle einzufügen. Wenn das Klassenobjekt oder die IDispatch-Schnittstelle nicht ermittelt werden konnten, löst GetActiveOleObject eine EOleSysError-Exception aus.