System.Variant.GetActiveObject
C++
static Variant __fastcall GetActiveObject(const String& ProgID);
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
function | public | sysvari.h | System | Variant |
Beschreibung
Ruft eine Referenz auf die IDispatch-Schnittstelle eines aktiven registrierten OLE-Automatisierungsobjekts ab und gibt sie in einem Variant-Objekt zurück.
GetActiveObject gibt eine Referenz auf die IDispatch-Schnittstelle des aktiven Objekts zurück. Die Klasse des Objekts wird im Parameter ProgID angegeben. ProgID ist die in der OLE-Registrierung gespeicherte Programm-ID der Klasse des aktiven Objekts.
Kann das Klassenobjekt oder die IDispatch-Schnittstelle nicht erfolgreich zurückgegeben werden, wird eine EOleSysError-Exception ausgelöst.
Tip: Wenn das Automatisierungsobjekt nicht ausgeführt wird oder nicht registriert ist, führen Sie es mit dem Element CreateObject von Variant aus.