System.Win.ComObj.GetActiveOleObject
Delphi
function GetActiveOleObject(const ClassName: string): IDispatch;
C++
extern DELPHI_PACKAGE _di_IDispatch __fastcall GetActiveOleObject(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
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.