Allgemeine MIDL-Befehlszeilensyntax

  • Artikel

Der MIDL-Compiler verarbeitet eine IDL-Datei und eine optionale Anwendungskonfigurationsdatei (ACF), um einen Satz von Ausgabedateien zu generieren. Die in der Schnittstellenattributeliste der IDL-Datei angegebenen Attribute bestimmen, ob der Compiler Quelldateien für eine RPC-Schnittstelle oder für eine benutzerdefinierte OLE-Schnittstelle generiert.

Optionen wechseln

     midl [command-line-switch [switch-options]] filename

Befehlszeilenschalter

Gibt Befehlszeilenoptionen für MIDL-Compiler an. Schalter können in beliebiger Reihenfolge angezeigt werden.

switch-options

Gibt optionen an, die jedem Switch zugeordnet sind. Gültige Optionen werden im Referenzeintrag für jeden MIDL-Compilerswitch beschrieben.

Dateiname

Gibt den Namen der IDL-Datei an. Diese Datei hat in der Regel die Erweiterung .idl, aber sie kann eine andere oder keine haben.

Bemerkungen

Die folgenden Listen zeigen die Standardnamen der Dateien, die für eine IDL-Datei namens Name.idl generiert wurden. Sie können Befehlszeilenoptionen verwenden, um diese Standardnamen zu überschreiben. Beachten Sie, dass der Name der IDL-Datei eine andere Erweiterung als .idl oder überhaupt keine Erweiterung haben kann.

Standardmäßig (wenn die Schnittstellenattributeliste nicht das Objekt oder das lokale Attribut 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 Objektattribute in der Liste der Schnittstellenattribute angezeigt wird, generiert der Compiler die folgenden Dateien für eine COM-Schnittstelle:

  • Schnittstellenproxydatei (name_p.c)
  • Schnittstellenheaderdatei (name.h)
  • Schnittstellen-UUID-Datei (name_I.c)

Wenn das lokale Attribut in der Liste der Schnittstellenattribute 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.

 

Die MIDL-Compileroptionen /env, /server, /sstub und /out wirken sich auf die Serverstubdatei aus.

Ab MIDL Version 6.0.359 lautet 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.