Allgemeine MIDL-Befehlszeilensyntax
Der MIDL-Compiler verarbeitet eine IDL-Datei und eine optionale Anwendungskonfigurationsdatei (Application Configuration File, ACF), um einen Satz von Ausgabedateien zu generieren. Die in der Schnittstellenattributliste der IDL-Datei angegebenen Attribute bestimmen, ob der Compiler Quelldateien für eine RPC-Schnittstelle oder für eine benutzerdefinierte OLE-Schnittstelle generiert.
Switch-Optionen
midl [command-line-switch [switch-options]] filename
-
Befehlszeilenschalter
-
Gibt MIDL-Compilerbefehlszeilenschalter an. Switches können in einer beliebigen Reihenfolge angezeigt werden.
-
switch-options
-
Gibt optionen an, die den einzelnen Schaltern zugeordnet sind. Gültige Optionen werden im Verweiseintrag für jeden MIDL-Compilerschalter beschrieben.
-
Dateiname
-
Gibt den Namen der IDL-Datei an. Diese Datei hat in der Regel die Erweiterung .idl, kann aber eine andere oder keine haben.
Bemerkungen
Die folgenden Listen enthalten die Standardnamen der Dateien, die für eine IDL-Datei namens Name.idl generiert wurden. Sie können Befehlszeilenschalter verwenden, um diese Standardnamen zu überschreiben. Beachten Sie, dass der Name der IDL-Datei eine andere Erweiterung als IDL oder gar keine Erweiterung haben kann.
Standardmäßig (d. h., wenn die Schnittstellenattributliste das Objekt oder das lokale Attribut nicht enthält), generiert der Compiler die folgenden Dateien für eine RPC-Schnittstelle:
- Clientstub (Name _ c.c)
- Serverstub (Name _ s.c)
- Headerdatei (name.h)
Wenn das Objektattribut in der Schnittstellenattributliste angezeigt wird, generiert der Compiler die folgenden Dateien für eine COM-Schnittstelle:
- Schnittstellenproxydatei (Name _ p.c)
- Schnittstellenheaderdatei (name.h)
- UUID-Datei der Schnittstelle (Name _ I.c)
Wenn das lokale Attribut in der Schnittstellenattributliste angezeigt wird, generiert der Compiler nur die Schnittstellenheaderdatei Name.h.
Der mit Microsoft RPC bereitgestellte MIDL-Compiler ruft den C-Präprozessor nach Bedarf auf, um die IDL-Datei zu verarbeiten. Der C-Compiler wird nicht automatisch aufgerufen, um generierte Dateien zu kompilieren.
Hinweis
Der mit Microsoft RPC bereitgestellte MIDL-Compiler verwendet eine andere Befehlszeilensyntax als der DCE-IDL-Compiler.
Der MIDL-Compiler wechselt /env, /server, /sstubund /out wirkt sich auf die Serverstubdatei aus.
Ab MIDL-Version 6.0.359 ist die Standardbefehlszeilenoption für den MIDL-Compiler /Oicf /robust. Um /robust zu deaktivieren, geben Sie die Option /no _ robust an.
Die Headerdatei
Die Headerdatei enthält Definitionen aller Datentypen und Vorgänge, die in der IDL-Datei deklariert sind. Die Headerdatei muss von allen Anwendungsmodulen eingeschlossen werden, die die definierten Vorgänge aufrufen, die definierten Vorgänge implementieren oder die definierten Typen bearbeiten.
Der MIDL-Compiler wechselt /header und /out wirkt sich auf die Headerdatei aus.