MIDL-Aufgabe
Umschließt das MIDL (Microsoft Interface Definition Language)-Compilertool ("midl.exe"). Weitere Informationen finden Sie unter "MIDL Command-Line Reference" auf der MSDN-Website.
Parameter
In der folgenden Tabelle werden die Parameter der MIDL-Aufgabe beschrieben. Die meisten Aufgabenparameter und einige Sätze von Parametern entsprechen einer Befehlszeilenoption.
Parameter |
Beschreibungen |
|---|---|
AdditionalIncludeDirectories |
Optionaler String[]-Parameter. Fügt ein Verzeichnis zur Liste der Verzeichnisse hinzu, die für importierte IDL-Dateien, eingeschlossene Headerdateien und Anwendungskonfigurationsdateien (ACF) gesucht werden. Weitere Informationen finden Sie unter der Option /I in "MIDL Command-Line Reference" auf der MSDN-Website. |
AdditionalOptions |
Optionaler String-Parameter. Eine Liste von Befehlszeilenoptionen. Beispiel: "/option1 /option2 /option#". Verwenden Sie diesen Parameter, um Befehlszeilenoptionen anzugeben, die nicht von einem beliebigen anderen MIDL-Aufgabenparameter dargestellt werden. Weitere Informationen finden Sie unter "MIDL Command-Line Reference" auf der MSDN-Website. |
ApplicationConfigurationMode |
Optionaler Boolean-Parameter. Wenn true, können einige ACF-Schlüsselwörter in der IDL-Datei verwendet werden. Weitere Informationen finden Sie unter den Optionen /app_config in "MIDL Command-Line Reference" auf der MSDN-Website. |
ClientStubFile |
Optionaler String-Parameter. Gibt den Namen der Clientstubdatei für eine RPC-Schnittstelle an. Weitere Informationen finden Sie unter der Option /cstub in "MIDL Command-Line Reference" auf der MSDN-Website. Sehen Sie sich auch den ServerStubFile-Parameter in dieser Tabelle an. |
CPreprocessOptions |
Optionaler String-Parameter. Gibt die Optionen für die Übergabe an den C/C++-Präprozessor an. Geben Sie eine durch Leerzeichen getrennte Liste von Präprozessoroptionen an. Weitere Informationen finden Sie unter der Option /cpp_opt in "MIDL Command-Line Reference" auf der MSDN-Website. |
DefaultCharType |
Optionaler String-Parameter. Gibt den Standardzeichentyp an, mit dem der C-Compiler den generierten Code kompiliert. Geben Sie einen der folgenden Werte an, von dem jeder einer Befehlszeilenoption entspricht.
ValueBefehlszeilenoption
Signed/char signed
Unsigned/char unsigned
Ascii/char ascii7
Weitere Informationen finden Sie unter der Option /char in "MIDL Command-Line Reference" auf der MSDN-Website. |
DllDataFileName |
Optionaler String-Parameter. Gibt den Dateinamen für die erstellte dlldata-Datei für eine Proxy-DLL an. Weitere Informationen finden Sie unter der Option /dlldata in "MIDL Command-Line Reference" auf der MSDN-Website. |
EnableErrorChecks |
Optionaler String-Parameter. Gibt den Fehlerüberprüfungstyp an, den die generierten Stubs zur Laufzeit durchführen. Geben Sie einen der folgenden Werte an, von dem jeder einer Befehlszeilenoption entspricht.
ValueBefehlszeilenoption
None/error none
EnableCustom/error
All/error all
Weitere Informationen finden Sie unter den Optionen /error in "MIDL Command-Line Reference" auf der MSDN-Website. |
ErrorCheckAllocations |
Optionaler Boolean-Parameter. Wenn true, prüfen Sie auf speicherbezogene Fehler. Weitere Informationen finden Sie unter den Optionen /error allocation in "MIDL Command-Line Reference" auf der MSDN-Website. |
ErrorCheckBounds |
Optionaler Boolean-Parameter. Wenn true, wird die Größe konform veränderlicher und veränderlicher Arrays mit der Übertragungslängenangabe verglichen. Weitere Informationen finden Sie unter der Option /error bounds_check in "MIDL Command-Line Reference" auf der MSDN-Website. |
ErrorCheckEnumRange |
Optionaler Boolean-Parameter. Wenn true, wird überprüft, ob Enumerationswerte im zulässigen Bereich sind. Weitere Informationen finden Sie in der /error enum-Option in der Befehlszeilenhilfe (/?) für "midl.exe". |
ErrorCheckRefPointers |
Optionaler Boolean-Parameter. Wenn true, stellen Sie sicher, dass keine Nullverweis-Zeiger an Clientstubs übergeben werden. Weitere Informationen finden Sie unter der Option /error ref in "MIDL Command-Line Reference" auf der MSDN-Website. |
ErrorCheckStubData |
Optionaler Boolean-Parameter. Wenn true, wird ein Stub generiert, der das Marshalling rückgängig machende Ausnahmen auf der Serverseite abfängt und sie zurück zum Client gibt. Weitere Informationen finden Sie unter den Optionen /error stub_data in "MIDL Command-Line Reference" auf der MSDN-Website. |
GenerateClientFiles |
Optionaler String-Parameter. Gibt an, ob der Compiler clientseitige C-Quelldateien für eine RPC-Schnittstelle generiert. Geben Sie einen der folgenden Werte an, von dem jeder einer Befehlszeilenoption entspricht.
ValueBefehlszeilenoption
None/client none
Stub/client stub
Weitere Informationen finden Sie unter den Optionen /client in "MIDL Command-Line Reference" auf der MSDN-Website. |
GenerateServerFiles |
Optionaler String-Parameter. Gibt an, ob der Compiler serverseitige C-Quelldateien für eine RPC-Schnittstelle generiert. Geben Sie einen der folgenden Werte an, von dem jeder einer Befehlszeilenoption entspricht.
ValueBefehlszeilenoption
None/server none
Stub/server stub
Weitere Informationen finden Sie unter der Option /server in "MIDL Command-Line Reference" auf der MSDN-Website. |
GenerateStublessProxies |
Optionaler Boolean-Parameter. Wenn true, werden vollständig interpretierte Stubs zusammen mit stubless-Proxys für Objektschnittstellen generiert. Weitere Informationen finden Sie unter der Option /Oicf in "MIDL Command-Line Reference" auf der MSDN-Website. |
GenerateTypeLibrary |
Optionaler Boolean-Parameter. Wenn true, wird keine Typbibliotheksdatei (.tlb) generiert. Weitere Informationen finden Sie unter der Option /notlb in "MIDL Command-Line Reference" auf der MSDN-Website. |
HeaderFileName |
Optionaler String-Parameter. Gibt den Namen der generierten Headerdatei an. Weitere Informationen finden Sie unter der /h- oder /header-Option unter "MIDL Command-Line Reference" auf der MSDN-Website. |
IgnoreStandardIncludePath |
Optionaler Boolean-Parameter. Wenn true, sucht die MIDL-Aufgabe nur die mit dem AdditionalIncludeDirectories-Schalter angegebenen Verzeichnisse, und ignoriert das aktuelle Verzeichnis und die von der INCLUDE-Umgebungsvariable angegebenen Verzeichnisse. Weitere Informationen finden Sie unter den Optionen /no_def_idir in "MIDL Command-Line Reference" auf der MSDN-Website. |
InterfaceIdentifierFileName |
Optionaler String-Parameter. Gibt den Namen der Schnittstellenbezeichnerdatei für eine COM-Schnittstelle an. Dies überschreibt den Standardnamen, der durch Hinzufügen von "_i.c" zum IDL-Dateinamen abgerufen wird. Weitere Informationen finden Sie unter der Option /iid in "MIDL Command-Line Reference" auf der MSDN-Website. |
LocaleID |
Optionaler int-Parameter. Gibt den Gebietsschemabezeichner an, der die Verwendung internationaler Zeichen in Eingabedateien, Dateinamen und Verzeichnispfaden aktiviert. Geben Sie einen dezimalen Gebietsschemabezeichner an. Weitere Informationen finden Sie unter der Option /lcid in "MIDL Command-Line Reference" auf der MSDN-Website. Siehe auch "Locale IDs Assigned by Microsoft" bei MSDN. |
MkTypLibCompatible |
Optionaler Boolean-Parameter. Wenn true, ist erforderlich, dass das Format der Eingabedatei mit mktyplib.exe, Version 2.03, kompatibel ist. Weitere Informationen finden Sie unter der Option /mktyplib203 in "MIDL Command-Line Reference" auf der MSDN-Website. Siehe auch "ODL File Syntax" auf der MSDN-Website. |
OutputDirectory |
Optionaler String-Parameter. Gibt das Standardverzeichnis an, in das die MIDL-Aufgabe Ausgabedateien schreibt. Weitere Informationen finden Sie unter der Option /out in "MIDL Command-Line Reference" auf der MSDN-Website. |
PreprocessorDefinitions |
Optionaler String[]-Parameter. Gibt ein oder mehr definiert-Elemente an. Das heißt, ein Name und ein optionaler Wert, die wie von einer #define-Direktive an den C-Präprozessor übergeben werden sollen. Die Form jeder Definition ist: name[=value]. Weitere Informationen finden Sie unter der Option /D in "MIDL Command-Line Reference" auf der MSDN-Website. Sehen Sie sich auch den UndefinePreprocessorDefinitions-Parameter in dieser Tabelle an. |
ProxyFileName |
Optionaler String-Parameter. Gibt den Namen der Schnittstellenproxydatei für eine COM-Schnittstelle an. Weitere Informationen finden Sie unter der Option /proxy in "MIDL Command-Line Reference" auf der MSDN-Website. |
RedirectOutputAndErrors |
Optionaler String-Parameter. Leitet die Ausgabe, z. B. Fehlermeldungen und Warnungen, von der Standardausgabe zur angegebenen Datei um. Weitere Informationen finden Sie unter der Option /o in "MIDL Command-Line Reference" auf der MSDN-Website. |
ServerStubFile |
Optionaler String-Parameter. Gibt den Namen der Serverstubdatei für eine RPC-Schnittstelle an. Weitere Informationen finden Sie unter den Optionen /sstub in "MIDL Command-Line Reference" auf der MSDN-Website. Sehen Sie sich auch den ClientStubFile-Parameter in dieser Tabelle an. |
Source |
Erforderlicher ITaskItem[]-Parameter. Gibt eine Liste von Quelldateien an, die durch Leerzeichen getrennt sind. |
StructMemberAlignment |
Optionaler String-Parameter. Gibt die Ausrichtung (Verpackungsebene) der Strukturen im Zielsystem an. Geben Sie einen der folgenden Werte an, von dem jeder einer Befehlszeilenoption entspricht.
ValueBefehlszeilenoption
NotSet<Keine>
1/Zp1
2/Zp2
4/Zp4
8/Zp8
Weitere Informationen finden Sie unter der Option /Zp in "MIDL Command-Line Reference" auf der MSDN-Website. Die /Zp-Option entspricht der /pack-Option und der Vorgänger-/align-Option. |
SuppressCompilerWarnings |
Optionaler Boolean-Parameter. Wenn true, werden Warnmeldungen in der MIDL-Aufgabe unterdrückt. Weitere Informationen finden Sie unter der Option /no_warn in "MIDL Command-Line Reference" auf der MSDN-Website. |
SuppressStartupBanner |
Optionaler Boolean-Parameter. Bei true wird die Anzeige der Urheberrechts- und Versionsnummernmeldung verhindert, wenn die Aufgabe startet. Weitere Informationen finden Sie unter der Option /nologo in "MIDL Command-Line Reference" auf der MSDN-Website. |
TargetEnvironment |
Optionaler String-Parameter. Gibt die Umgebung an, in der die Anwendung ausgeführt wird. Geben Sie einen der folgenden Werte an, von dem jeder einer Befehlszeilenoption entspricht.
ValueBefehlszeilenoption
NotSet<Keine>
Win32/env win32
Itanium/env ia64
X64/env x64
Weitere Informationen finden Sie unter der Option /env in "MIDL Command-Line Reference" auf der MSDN-Website. |
TrackerLogDirectory |
Optionaler String-Parameter. Gibt das Zwischenverzeichnis an, in dem Nachverfolgungsprotokolle für diese Aufgabe gespeichert werden. |
TypeLibFormat |
Optionaler String-Parameter. Gibt das Format der Typbibliotheksdatei an. Geben Sie einen der folgenden Werte an, von dem jeder einer Befehlszeilenoption entspricht.
ValueBefehlszeilenoption
NewFormat/newtlb
OldFormat/oldtlb
Weitere Informationen finden Sie unter der Option /newtlb und /oldtlb in "MIDL Command-Line Reference" auf der MSDN-Website. |
TypeLibraryName |
Optionaler String-Parameter. Gibt den Namen der Typbibliotheksdatei an. Weitere Informationen finden Sie unter der Option /tlb in "MIDL Command-Line Reference" auf der MSDN-Website. |
UndefinePreprocessorDefinitions |
Optionaler String[]-Parameter. Entfernt jede vorherige Definition eines Namens durch das Übergeben des Namens an den C-Präprozessor wie bei einer #undefine-Direktive. Geben Sie mindestens einen zuvor definierten Namen an. Weitere Informationen finden Sie unter der Option /U in "MIDL Command-Line Reference" auf der MSDN-Website. Sehen Sie sich auch den PreprocessorDefinitions-Parameter in dieser Tabelle an. |
ValidateAllParameters |
Optionaler Boolean-Parameter. Wenn true, werden zusätzliche Fehlerüberprüfungsinformationen generiert, die verwendet werden, um zur Laufzeit Integritätsprüfungen auszuführen. Wenn false, werden die Fehlerüberprüfungsinformationen nicht generiert. Weitere Informationen finden Sie unter den Optionen /robust und /no_robust in "MIDL Command-Line Reference" auf der MSDN-Website. |
WarnAsError |
Optionaler Boolean-Parameter. Wenn der Wert true lautet, werden alle Warnungen als Fehler behandelt. Wenn der WarningLevel-MIDL-Aufgabenparameter nicht angegeben ist, werden Warnungen auf der Standardebene, Ebene 1, als Fehler behandelt. Weitere Informationen finden Sie unter den /WX-Optionen in "MIDL Command-Line Reference" auf der MSDN-Website. Sehen Sie sich auch den WarningLevel -Parameter in dieser Tabelle an. |
WarningLevel |
Optionaler String-Parameter. Gibt den auszugebenden Schweregrad von (Warnstufe) Warnungen an. Keine Warnung wird für den Wert 0 ausgegeben. Andernfalls wird eine Warnung ausgegeben, wenn die Warnstufe in numerischer Form kleiner oder gleich dem angegebenen Wert ist. Geben Sie einen der folgenden Werte an, von dem jeder einer Befehlszeilenoption entspricht.
ValueBefehlszeilenoption
0/W0
1/W1
2/W2
3/W3
4/W4
Weitere Informationen finden Sie unter den Optionen /W in "MIDL Command-Line Reference" auf der MSDN-Website. Sehen Sie sich auch den WarnAsError -Parameter in dieser Tabelle an. |