MIDL 工作
包裝 Microsoft 介面定義語言 (MIDL) 編譯器工具 (midl.exe)。 如需詳細資訊，請參閱 MSDN 網站上的有關「MIDL 命令列參考」的文章。
參數
下表說明 MIDL 工作的參數。 大部分的工作參數及部分參數集會對應到命令列選項。
參數 |
描述 |
||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
AdditionalIncludeDirectories |
選擇性 String[] 參數。 在目錄的清單中加入目錄 (已在這個清單中搜尋匯入的 IDL 檔案，包含標頭檔和應用程式組態檔 (ACF))。 如需詳細資訊，請參閱 MSDN 網站上＜MIDL 命令列參考＞中的 /I 選項。 |
||||||||||||
AdditionalOptions |
選擇性 String 參數。 命令列選項的清單。 例如 "/option1 /option2 /option#"。 使用這個參數來指定並非由其他任何 MIDL 工作參數代表的命令列選項。 如需詳細資訊，請參閱 MSDN 網站上的有關「MIDL 命令列參考」的文章。 |
||||||||||||
ApplicationConfigurationMode |
選擇性 Boolean 參數。 如果 true，可讓您在 IDL 檔案中使用某些 ACF 關鍵字。 如需詳細資訊，請參閱 MSDN 網站上＜MIDL 命令列參考＞中的 /app_config 選項。 |
||||||||||||
ClientStubFile |
選擇性 String 參數。 指定 RPC 介面的用戶端 Stub 檔案的名稱。 如需詳細資訊，請參閱 MSDN 網站上＜MIDL 命令列參考＞中的 /cstub 選項。 請參閱這個資料表中的 ServerStubFile 參數。 |
||||||||||||
CPreprocessOptions |
選擇性 String 參數。 指定要傳遞到 C/C ++ 前置處理器的選項。 指定以空格分隔的前置處理器選項清單。 如需詳細資訊，請參閱 MSDN 網站上＜MIDL 命令列參考＞中的 /cpp_opt 選項。 |
||||||||||||
DefaultCharType |
選擇性 String 參數。 指定預設字元類型，C 編譯器會使用此類型來編譯產生的程式碼。 指定下列其中一個值，其中每一個値均對應到一個命令列選項。
如需詳細資訊，請參閱 MSDN 網站上＜MIDL 命令列參考＞中的 /char 選項。 |
||||||||||||
DllDataFileName |
選擇性 String 參數。 指定針對 Proxy DLL 產生之 dlldata 檔案的檔案名稱。 如需詳細資訊，請參閱 MSDN 網站上＜MIDL 命令列參考＞中的 /dlldata 選項。 |
||||||||||||
EnableErrorChecks |
選擇性 String 參數。 指定所產生的 Stub 會於執行階段執行的錯誤檢查類型。 指定下列其中一個值，其中每一個値均對應到一個命令列選項。
如需詳細資訊，請參閱 MSDN 網站上＜MIDL 命令列參考＞中的 /error 選項。 |
||||||||||||
ErrorCheckAllocations |
選擇性 Boolean 參數。 如果 true，請檢查記憶體不足錯誤。 如需詳細資訊，請參閱 MSDN 網站上＜MIDL 命令列參考＞中的 /error allocation 選項。 |
||||||||||||
ErrorCheckBounds |
選擇性 Boolean 參數。 如果 true，請針對傳輸長度規格檢查不同標準和不同陣列的大小。 如需詳細資訊，請參閱 MSDN 網站上＜MIDL 命令列參考＞中的 /error bounds_check 選項。 |
||||||||||||
ErrorCheckEnumRange |
選擇性 Boolean 參數。 如果 true，請檢查列舉值在允許的範圍內。 如需詳細資訊，請參閱 midl.exe 命令列說明 (/?) 中的 /error enum 選項。 |
||||||||||||
ErrorCheckRefPointers |
選擇性 Boolean 參數。 如果 true，請檢查是否沒有將任何 Null 參考指標傳遞至用戶端 Stub。 如需詳細資訊，請參閱 MSDN 網站上＜MIDL 命令列參考＞中的 /error ref 選項。 |
||||||||||||
ErrorCheckStubData |
選擇性 Boolean 參數。 如果 true 會產生 Stub，這個 Stub 會攔截伺服器端的解封送處理例外狀況，並將這些例外狀況傳播回用戶端。 如需詳細資訊，請參閱 MSDN 網站上＜MIDL 命令列參考＞中的 /error stub_data 選項。 |
||||||||||||
GenerateClientFiles |
選擇性 String 參數。 指定編譯器是否會產生 RPC 介面的用戶端 C 原始程式檔。 指定下列其中一個值，其中每一個値均對應到一個命令列選項。
如需詳細資訊，請參閱 MSDN 網站上＜MIDL 命令列參考＞中的 /client 選項。 |
||||||||||||
GenerateServerFiles |
選擇性 String 參數。 指定編譯器是否會產生 RPC 介面的伺服器端 C 原始程式檔。 指定下列其中一個值，其中每一個値均對應到一個命令列選項。
如需詳細資訊，請參閱 MSDN 網站上＜MIDL 命令列參考＞中的 /server 選項。 |
||||||||||||
GenerateStublessProxies |
選擇性 Boolean 參數。 如果 true，會產生完全解譯的 Stub 及物件介面的 Stubless Proxy。 如需詳細資訊，請參閱 MSDN 網站上＜MIDL 命令列參考＞中的 /Oicf 選項。 |
||||||||||||
GenerateTypeLibrary |
選擇性 Boolean 參數。 如果 true，不會產生型別程式庫 (.tlb) 檔案。 如需詳細資訊，請參閱 MSDN 網站上＜MIDL 命令列參考＞中的 /notlb 選項。 |
||||||||||||
HeaderFileName |
選擇性 String 參數。 指定產生的標頭檔的名稱。 如需詳細資訊，請參閱 MSDN 網站上「MIDL 命令列參考」中的 /h 或 /header 選項。 |
||||||||||||
IgnoreStandardIncludePath |
選擇性 Boolean 參數。 如果 true，MIDL 工作只會搜尋使用 AdditionalIncludeDirectories 參數所指定的目錄，並忽略目前的目錄和 INCLUDE 環境變數所指定的目錄。 如需詳細資訊，請參閱 MSDN 網站上＜MIDL 命令列參考＞中的 /no_def_idir 選項。 |
||||||||||||
InterfaceIdentifierFileName |
選擇性 String 參數。 指定 COM 介面的「介面識別項檔案」(Interface Identifier File) 名稱。 這樣會覆寫在 IDL 檔案名稱中加入 "_i.c"IDL 所取得的預設名稱。 如需詳細資訊，請參閱 MSDN 網站上＜MIDL 命令列參考＞中的 /iid 選項。 |
||||||||||||
LocaleID |
選擇性 int 參數。 指定「地區設定識別項」(Locale Identifier)，此識別項可讓您在輸入檔、檔案名稱和目錄路徑中使用國際字元。 指定十進位地區設定識別碼。 如需詳細資訊，請參閱 MSDN 網站上＜MIDL 命令列參考＞中的 /lcid 選項。 亦請參閱 MSDN 的「Microsoft 指派的地區設定 ID」。 |
||||||||||||
MkTypLibCompatible |
選擇性 Boolean 參數。 如果 true，輸入檔的格式必須與 mktyplib.exe 2.03 版相容。 如需詳細資訊，請參閱 MSDN 網站上＜MIDL 命令列參考＞中的 /mktyplib203 選項。 亦請參閱 MSDN 網站上的「ODL 檔案語法」。 |
||||||||||||
OutputDirectory |
選擇性 String 參數。 指定 MIDL 工作寫入輸出檔的預設目錄。 如需詳細資訊，請參閱 MSDN 網站上＜MIDL 命令列參考＞中的 /out 選項。 |
||||||||||||
PreprocessorDefinitions |
選擇性 String[] 參數。 指定一或多個「定義」(Define)；也就是要視同由 #define 指示詞傳遞至 C 前置處理器的名稱和選擇性的値。 每個定義的格式為 name[=value]。 如需詳細資訊，請參閱 MSDN 網站上＜MIDL 命令列參考＞中的 /D 選項。 同時，請參閱這個資料表中的 UndefinePreprocessorDefinitions 參數。 |
||||||||||||
ProxyFileName |
選擇性 String 參數。 指定 COM 介面的介面 Proxy 檔的名稱。 如需詳細資訊，請參閱 MSDN 網站上＜MIDL 命令列參考＞中的 /proxy 選項。 |
||||||||||||
RedirectOutputAndErrors |
選擇性 String 參數。 從標準輸出將輸出 (例如錯誤訊息和警告) 重新導向至指定檔案。 如需詳細資訊，請參閱 MSDN 網站上＜MIDL 命令列參考＞中的 /o 選項。 |
||||||||||||
ServerStubFile |
選擇性 String 參數。 指定 RPC 介面的用戶端 Stub 檔案的名稱。 如需詳細資訊，請參閱 MSDN 網站上「MIDL 命令列參考」中的 /sstub 選項。 同時，請參閱這個資料表中的 ClientStubFile 參數。 |
||||||||||||
Source |
必要的 ITaskItem[] 參數。 指定以空格分隔的原始程式檔清單。 |
||||||||||||
StructMemberAlignment |
選擇性 String 參數。 指定目標系統中結構的對齊方式 (「封裝層級」(Packing Level))。 指定下列其中一個值，其中每一個値均對應到一個命令列選項。
如需詳細資訊，請參閱 MSDN 網站上＜MIDL 命令列參考＞中的 /Zp 選項。 /Zp選項相當於/pack選項或舊版/align選項。 |
||||||||||||
SuppressCompilerWarnings |
選擇性 Boolean 參數。 如果 true，會隱藏來自 MIDL 工作的警告訊息。 如需詳細資訊，請參閱 MSDN 網站上＜MIDL 命令列參考＞中的 /no_warn 選項。 |
||||||||||||
SuppressStartupBanner |
選擇性 Boolean 參數。 如果 true，可防止在工作啟動時顯示版權和版本號碼訊息。 如需詳細資訊，請參閱 MSDN 網站上＜MIDL 命令列參考＞中的 /nologo 選項。 |
||||||||||||
TargetEnvironment |
選擇性 String 參數。 指定應用程式執行的環境。 指定下列其中一個值，其中每一個値均對應到一個命令列選項。
如需詳細資訊，請參閱 MSDN 網站上＜MIDL 命令列參考＞中的 /env 選項。 |
||||||||||||
TrackerLogDirectory |
選擇性 String 參數。 指定用於儲存此工作之追蹤記錄檔的中繼目錄。 |
||||||||||||
TypeLibFormat |
選擇性 String 參數。 指定型別程式庫檔案的格式。 指定下列其中一個值，其中每一個値均對應到一個命令列選項。
如需詳細資訊，請參閱 MSDN 網站上＜MIDL 命令列參考＞中的 /newtlb 和 /oldtlb 選項。 |
||||||||||||
TypeLibraryName |
選擇性 String 參數。 指定型別程式庫檔案的名稱。 如需詳細資訊，請參閱 MSDN 網站上＜MIDL 命令列參考＞中的 /tlb 選項。 |
||||||||||||
UndefinePreprocessorDefinitions |
選擇性 String[] 參數。 將名稱傳遞至 C 前處理器，如同以 #undefine 指示詞傳遞般，以移除任何舊版的名稱定義。 指定一或多個先前定義的名稱。 如需詳細資訊，請參閱 MSDN 網站上＜MIDL 命令列參考＞中的 /U 選項。 同時，請參閱這個資料表中的 PreprocessorDefinitions 參數。 |
||||||||||||
ValidateAllParameters |
選擇性 Boolean 參數。 如果 true，會產生用於在執行階段執行完整性檢查的其他錯誤檢查資訊。 如果 false，不會產生錯誤檢查資訊。 如需詳細資訊，請參閱 MSDN 網站上「MIDL 命令列參考」中的 /robust 和 /no_robust 選項。 |
||||||||||||
WarnAsError |
選擇性 Boolean 參數。 如果為 true，則將所有警告都視為錯誤。 如果未指定 WarningLevel MIDL 工作參數，則會將預設層級 (層級 1) 的警告視為錯誤。 如需詳細資訊，請參閱 MSDN 網站上「MIDL 命令列參考」中的 /WX選項。 同時，請參閱這個資料表中的 WarningLevel 參數。 |
||||||||||||
WarningLevel |
選擇性 String 參數。 指定要發出之警告的嚴重性 (「警告層級」(Warning Level))。 沒有發出 0 值的警告。 否則，如果警告層級的數字小魚貨等於指定的値，就會發出警告。 指定下列其中一個值，其中每一個値均對應到一個命令列選項。
如需詳細資訊，請參閱 MSDN 網站上「MIDL 命令列參考」中的 /W選項。 同時，請參閱這個資料表中的 WarnAsError 參數。 |