Freigeben über


GETOBJECT( )-Funktion

Aktiviert ein Automatisierungsobjekt und erstellt einen Verweis auf das Objekt.

GETOBJECT(cFileName | Moniker [, cClassName])

Rückgabetypen

Objektreferenz

Parameter

  • cFileName
    Gibt den vollständigen Pfad und den Namen der zu aktivierenden Datei an. Die Anwendung muss nicht angegeben werden, da die OLE Dynamic-Link Libraries die zu startende Anwendung anhand des angegebenen Dateinamens bestimmen.

    Der folgende Code startet z. B. Microsoft Excel, öffnet eine Datei mit dem Namen BUDGET.XLS, und erstellt mit Hilfe einer Objektvariablen namens MBUDVAR einen Verweis:

    MBUDVAR = GETOBJECT('C:\EXCEL\WORK\BUDGET.XLS')
    
  • Moniker
    Der Bezeichner eines COM-Objekts, der die IMoniker-Schnittstelle implementiert. Ein Moniker kann einer der folgenden Typen sein: Datei, Element, allgemeine Zusammensetzung, Anti-, Zeiger und URL. Detaillierte Informationen zu COM-Monikers finden Sie im Microsoft Developer Network unter "IMoniker".

  • cClassName
    Gibt den Klassennamen des abzurufenden Objekts an. Einige Anwendungen können in einer Datei mehrere Objekttypen speichern. Dies ermöglicht Ihnen, den Klassennamen zur Angabe des zu aktivierenden Objekts zu verwenden. Wenn ein Textverarbeitungssystem z. B. seine Dokumente, Makrodefinitionen und Symbolleisten-Objekte in ein und derselben Datei speichert, können Sie mit dem folgenden Befehl einen Verweis auf die Dokumentdatei erstellen:

    MDOCFILE = GETOBJECT('C:\WRDPROC\MYDOC.DOC','WrdProc.Document')
    

    Bei einigen Serveranwendungen wird bei jeder Ausführung von GETOBJECT( ) eine zusätzliche Instanz der Anwendung gestartet, die weiteren Speicherplatz belegt. Wird die Anwendung bereits ausgeführt, können Sie verhindern, dass weitere Instanzen der Anwendung gestartet werden, indem Sie entsprechend des folgenden Beispiels FileName weglassen und ClassName angeben.

    oleApp = GETOBJECT(, "Excel.Application")
    

Hinweise

Verwenden Sie GETOBJECT( ), um ein Automatisierungsobjekt aus einer Datei zu aktivieren und dem Objekt über eine Speichervariable oder ein Arrayelement einem Verweis zuzuweisen.

Wenn Sie einen ungültigen Datei- oder Klassennamen angeben, wird ein OLE-Fehler angezeigt, und die GETOBJECT( )-Funktion gibt eine leere Zeichenfolge zurück.

Beispiel

Auf einem Netzwerk, auf dem Active Directory Services implementiert sind, können Sie das Netzwerk nach Informationen zu einem bestimmten Benutzer abfragen.

   *  Replace "DomainName" with the domain name, and "UserLoginID"
   *  with the login ID of the user you are looking up.
   oUser = GetObject("WinNT://DomainName/UserLoginID,user")
   ? oUser.FullName

Siehe auch

COMCLASSINFO( ) | CREATEOBJECT( ) | DEFINE CLASS | SET OLEOBJECT | GETINTERFACE( )