MIDL-Aufgabe
Umschließt das MIDL-Compilertool (Microsoft Interface Definition Language), midl.exe. Weitere Informationen finden Sie unter MIDL-Befehlszeilenreferenz.
Parameter
Im Folgenden werden die Parameter der MIDL-Aufgabe beschrieben. Die meisten Aufgabenparameter und einige andere Parameter entsprechen einer Befehlszeilenoption.
AdditionalIncludeDirectories
Optionaler String[] -Parameter.
Fügt ein Verzeichnis zur Liste der Verzeichnisse hinzu, die auf importierte IDL-Dateien durchsucht werden, einschließlich Headerdateien und Anwendungskonfigurationsdateien (ACF).
Weitere Informationen finden Sie unter der Option /I in der MIDL-Befehlszeilenreferenz.
AdditionalOptions
Optionaler String -Parameter.
Eine Liste der Befehlszeilenoptionen. Zum Beispiel: /</option1> /<option2> /<option#>. Verwenden Sie diesen Parameter, um Befehlszeilenoptionen anzugeben, die nicht durch einen anderen MIDL-Aufgabenparameter repräsentiert werden.
Weitere Informationen finden Sie unter MIDL-Befehlszeilenreferenz.
ApplicationConfigurationMode
Optionaler Boolean-Parameter.
Wenn
true, dann können Sie einige ACF-Schlüsselwörter in der IDL-Datei benutzen.Weitere Informationen finden Sie unter der Option /app_config in der MIDL-Befehlszeilenreferenz.
ClientStubFile
Optionaler String -Parameter.
Gibt den Namen der Client-Stub-Datei für eine RPC-Schnittstelle an.
Weitere Informationen finden Sie unter der Option /cstub in der MIDL-Befehlszeilenreferenz. Siehe auch den Parameter ServerStubFile in dieser Tabelle.
CPreprocessOptions
Optionaler String -Parameter.
Gibt Optionen für die Übergabe an den C++-Präprozessor an. Geben eine durch Leerzeichen getrennte Liste mit Präprozessoroptionen an. Muss die Option
/Eenthalten.Weitere Informationen finden Sie unter der Option /cpp_opt in der MIDL-Befehlszeilenreferenz.
DefaultCharType
Optionaler String -Parameter.
Gibt den standardmäßigen Zeichentyp an, den der C-Compiler verwendet, um den generierten Code zu kompilieren.
Geben Sie einen der folgenden Werte an, von denen jeder einer Befehlszeilenoption entspricht.
Wert Befehlszeilenoption Signed /char signed Unsigned /char unsigned Ascii /char ascii7 Weitere Informationen finden Sie unter der Option /char in der MIDL-Befehlszeilenreferenz.
DllDataFileName
Optionaler String -Parameter.
Gibt den Dateinamen für die generierte dlldata-Datei für eine Proxy-DLL an.
Weitere Informationen finden Sie unter der Option /dlldata in der MIDL-Befehlszeilenreferenz.
EnableErrorChecks
Optionaler String -Parameter.
Gibt den Fehlertyp an, und überprüft, dass die generierten Stubs in der Laufzeit ausgeführt werden.
Geben Sie einen der folgenden Werte an, von denen jeder einer Befehlszeilenoption entspricht.
Wert Befehlszeilenoption Keine /error none EnableCustom /error Alle /error all Weitere Informationen finden Sie unter der Option /error in der MIDL-Befehlszeilenreferenz.
ErrorCheckAllocations
Optionaler Boolean-Parameter.
Wenn
true, stellen Sie sicher, das keine Fehler aufgrund von unzureichendem Arbeitsspeicher aufgetreten sind.Weitere Informationen finden Sie unter der Option /error allocation in der MIDL-Befehlszeilenreferenz.
ErrorCheckBounds
Optionaler Boolean-Parameter.
Wenn
true, dann wird die Größe der konform-variierenden und variierenden Arrays mit der Übertragungslängenspezifikation abgeglichen.Weitere Informationen finden Sie unter der Option /error bounds_check in der MIDL-Befehlszeilenreferenz.
ErrorCheckEnumRange
Optionaler Boolean-Parameter.
Wenn
true, wird überprüft, ob sich die Enumerationswerte im zulässigen Bereich befinden.Weitere Informationen finden Sie unter der Option /error enum in der Befehlszeilenhilfe ( /? ) für midl.exe.
ErrorCheckRefPointers
Optionaler Boolean-Parameter.
Wenn
true, stellen Sie sicher, dass keine NULL-Verweiszeiger an die Client-Stubs übergeben werden.Weitere Informationen finden Sie unter der Option /error ref in der MIDL-Befehlszeilenreferenz.
ErrorCheckStubData
Optionaler Boolean-Parameter.
Wenn
true, wird ein Stub generiert, das Unmarshalling-Ausnahmen auf Serverseite erkennt, und überträgt sie zurück an den Client.Weitere Informationen finden Sie unter der Option /error stub_data in der MIDL-Befehlszeilenreferenz.
GenerateClientFiles
Optionaler String -Parameter.
Legt fest, ob der Compiler clientseitige C-Quelldateien für eine RPC-Schnittstelle generiert.
Geben Sie einen der folgenden Werte an, von denen jeder einer Befehlszeilenoption entspricht.
Wert Befehlszeilenoption Keine /client none Stub /client stub Weitere Informationen finden Sie unter der Option /client in der MIDL-Befehlszeilenreferenz.
GenerateServerFiles
Optionaler String -Parameter.
Legt fest, ob der Compiler serverseitige C-Quelldateien für eine RPC-Schnittstelle generiert.
Geben Sie einen der folgenden Werte an, von denen jeder einer Befehlszeilenoption entspricht.
Wert Befehlszeilenoption Keine /server none Stub /server stub Weitere Informationen finden Sie unter der Option /server in der MIDL-Befehlszeilenreferenz.
GenerateStublessProxies
Optionaler Boolean-Parameter.
Wenn
true, werden vollständig interpretierte Stubs mit Proxys ohne Stubs für Objektschnittstellen generiert.Weitere Informationen finden Sie unter der Option /Oicf in der MIDL-Befehlszeilenreferenz.
GenerateTypeLibrary
Optionaler Boolean-Parameter.
Wenn
true, dann wird keine Typbibliotheksdatei ( .tlb) generiert.Weitere Informationen finden Sie unter der Option /notlb in der MIDL-Befehlszeilenreferenz.
HeaderFileName
Optionaler String -Parameter.
Gibt den Namen der generierten Headerdatei an.
Weitere Informationen finden Sie unter der Option /h oder /header in der MIDL-Befehlszeilenreferenz.
IgnoreStandardIncludePath
Optionaler Boolean-Parameter.
Wenn
true, dann sucht die MIDL-Aufgabe nur in den angegebenen Verzeichnissen mithilfe des Schalters AdditonalIncludeDirectories, und ignoriert das aktuelle Verzeichnis und die durch die Umgebungsvariable „INCLUDE“ angegebenen Verzeichnisse.Weitere Informationen finden Sie unter der Option /no_def_idir in der MIDL-Befehlszeilenreferenz.
InterfaceIdentifierFileName
Optionaler String -Parameter.
Gibt den Namen für die Schnittstellen-Bezeichnerdatei für die COM-Schnittstelle an. Dies setzt den Standardnamen außer Kraft, der durch ein Anhängen von „_i.c“ an den IDL-Dateinamen entsteht.
Weitere Informationen finden Sie unter der Option /iid in der MIDL-Befehlszeilenreferenz.
LocaleID
Optionaler int-Parameter.
Gibt den Gebietsschemabezeichner an, der den Gebrauch von internationalen Zeichen in der Eingabedatei, dem Dateinamen und den Verzeichnispfaden ermöglicht. Geben Sie einen dezimalen Gebietsschemabezeichner an.
Weitere Informationen finden Sie unter der Option /lcid in der MIDL-Befehlszeilenreferenz. Siehe auch Gebietsschemabezeichner.
MkTypLibCompatible
Optionaler Boolean-Parameter.
Wenn
true, dann muss das Format der Eingabedatei mit mktyplib.exe Version 2.03 kompatibel sein.Weitere Informationen finden Sie unter Option /mktyplib203 in der MIDL-Befehlszeilenreferenz. Siehe auch ODL-Dateisyntax auf der MSDN-Website.
OutputDirectory
Optionaler String -Parameter.
Gibt das Standardverzeichnis an, in dem die MIDL-Aufgabe Ausgabedateien schreibt.
Weitere Informationen finden Sie unter der Option /out in der MIDL-Befehlszeilenreferenz.
PreprocessorDefinitions
Optionaler String[] -Parameter.
Gibt einen oder mehrere defines an; d.h., einen Namen oder einen optionalen Wert, der an einen C-Präprozessor wie von einer
#define-Direktive weitergegeben werden soll. Jedes „define“ ist folgendermaßen aufgebaut: name[=value] .Weitere Informationen finden Sie unter der Option /D in der MIDL-Befehlszeilenreferenz. Siehe auch die Parameter UndefinePreprocessorDefinitions in dieser Tabelle.
ProxyFileName
Optionaler String -Parameter.
Gibt den Namen für die Schnittstellen-Proxydatei für die COM-Schnittstelle an.
Weitere Informationen finden Sie unter der Option /proxy in der MIDL-Befehlszeilenreferenz.
RedirectOutputAndErrors
Optionaler String -Parameter.
Leitet Ausgaben, wie z.B. Fehlermeldungen und Warnungen, aus der Standardausgabe in die angegebenen Dateien weiter.
Weitere Informationen finden Sie unter der Option /o in der MIDL-Befehlszeilenreferenz.
ServerStubFile
Optionaler String -Parameter.
Gibt den Namen der Server-Stub-Datei für eine RPC-Schnittstelle an.
Weitere Informationen finden Sie unter der Option /sstub in der MIDL-Befehlszeilenreferenz. Siehe auch den Parameter ClientStubFile in dieser Tabelle.
Quelle
Erforderlicher
ITaskItem[]-Parameter.Gibt eine durch Leerzeichen getrennte Liste der Quelldateien an.
StructMemberAlignment
Optionaler String -Parameter.
Gibt die Zuweisung (Komprimierungsebene) der Strukturen im Zielsystem an.
Geben Sie einen der folgenden Werte an, von denen jeder einer Befehlszeilenoption entspricht.
Wert Befehlszeilenoption NotSet <Keine> 1 /Zp1 2 /Zp2 4 /Zp4 8 /Zp8 Weitere Informationen finden Sie unter der Option /Zp in der MIDL-Befehlszeilenreferenz. Die Option /Zp ist äquivalent zu der Option /pack und der älteren Option /align.
SuppressCompilerWarnings
Optionaler Boolean-Parameter.
Wenn
true, dann werden Warnmeldungen aus der MIDL-Aufgabe unterdrückt.Weitere Informationen finden Sie unter der Option /no_warn in der MIDL-Befehlszeilenreferenz.
SuppressStartupBanner
Optionaler
Boolean-Parameter.Bei
truewird die Anzeige der Copyright- und Versionsnummernmeldung bei Aufgabenstart verhindert.Weitere Informationen finden Sie unter der Option /nologo in der MIDL-Befehlszeilenreferenz.
TargetEnvironment
Optionaler String-Parameter.
Gibt die Umgebung an, in der die Anwendung ausgeführt wird.
Geben Sie einen der folgenden Werte an, von denen jeder einer Befehlszeilenoption entspricht.
Wert Befehlszeilenoption NotSet <Keine> Win32 /env win32 Itanium /env ia64 X64 /env x64 Weitere Informationen finden Sie unter der Option /env in der MIDL-Befehlszeilenreferenz.
TrackerLogDirectory
Optionaler
String-Parameter.Gibt das Zwischenverzeichnis an, in dem die Nachverfolgungsprotokolle für diese Aufgabe gespeichert sind.
TypeLibFormat
Optionaler String-Parameter.
Gibt das Format der Typbibliotheksdatei an.
Geben Sie einen der folgenden Werte an, von denen jeder einer Befehlszeilenoption entspricht.
Wert Befehlszeilenoption NewFormat /newtlb OldFormat /oldtlb Weitere Informationen finden Sie unter den Optionen /newtlb und /oldtlb in der MIDL-Befehlszeilenreferenz.
TypeLibraryName
Optionaler String-Parameter.
Gibt den Namen der Typbibliotheksdatei an.
Weitere Informationen finden Sie unter der Option /tlb in der MIDL-Befehlszeilenreferenz.
UndefinePreprocessorDefinitions
Optionaler String[] -Parameter.
Entfernt jede vorherige Definition eines Namens, indem er den Namen wie eine
#undefine-Direktive an den C-Präprozessor weitergibt. Geben Sie eine oder mehrere vorher definierte Namen ein.Weitere Informationen finden Sie unter der Option /U in der MIDL-Befehlszeilenreferenz. Siehe auch die Parameter PreprocessorDefinitions in dieser Tabelle.
ValidateAllParameters
Optionaler
Boolean-Parameter.Wenn
true, dann werden zusätzliche Dateifehler-Überprüfungsinformationen generiert, die für Integritätsprüfungen in der Laufzeit verwendet werden. Wennfalse, dann werden keine Dateifehler-Überprüfungsinformationen generiert.Weitere Informationen finden Sie unter den Optionen /robust und /no_robust in der MIDL-Befehlszeilenreferenz.
WarnAsError
Optionaler
Boolean-Parameter.Wenn
true, werden alle Warnungen als Fehler behandelt.Wenn der MIDL-Aufgabenparameter WarningLevel nicht angegeben ist, werden Warnungen auf Standardlevel und auf Level 1 wie Fehler behandelt.
Weitere Informationen finden Sie unter der Option /WX in der MIDL-Befehlszeilenreferenz. Siehe auch den Parameter WarningLevel in dieser Tabelle.
WarningLevel
Optionaler String-Parameter.
Gibt den Schweregrad (Warnstufe) von auszugebenden Warnungen an. Für den Wert 0 wird keine Warnung ausgegeben. Andernfalls wird eine Warnung ausgegeben, wenn ihre Warnstufe numerisch kleiner als oder gleich der angegebene Wert ist.
Geben Sie einen der folgenden Werte an, von denen jeder einer Befehlszeilenoption entspricht.
Wert Befehlszeilenoption 0 /W0 1 /W1 2 /W2 3 /W3 4 /W4 Weitere Informationen finden Sie unter der Option /W in der MIDL-Befehlszeilenreferenz. Siehe auch den Parameter WarningLevel in dieser Tabelle.
Siehe auch
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für