MIDL 작업
MIDL(Microsoft Interface Definition Language) 컴파일러 도구인 midl.exe를 래핑합니다. 자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"를 참조하십시오.
매개 변수
다음 표에서는 MIDL 작업의 매개 변수에 대해 설명합니다. 대부분의 작업 매개 변수 및 일부 매개 변수 집합은 명령줄 옵션에 해당합니다.
Parameter |
설명 |
|---|---|
AdditionalIncludeDirectories |
선택적 String[] 매개 변수입니다. 가져온 IDL 파일, 포함된 헤더 파일 및 응용 프로그램 구성 파일(ACF)을 검색하는 디렉터리 목록에 디렉터리를 추가합니다. 자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /I 옵션을 참조하십시오. |
AdditionalOptions |
선택적 String 매개 변수입니다. 명령줄 옵션의 목록입니다. 예를 들어, "/option1 /option2 /option#"입니다. 이 매개 변수를 사용하여 다른 MIDL 작업 매개 변수로 표현되지 않는 명령줄 옵션을 지정합니다. 자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"를 참조하십시오. |
ApplicationConfigurationMode |
선택적 Boolean 매개 변수입니다. true인 경우 IDL 파일에서 일부 ACF 키워드를 사용할 수 있습니다. 자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /app_config 옵션을 참조하십시오. |
ClientStubFile |
선택적 String 매개 변수입니다. RPC 인터페이스에 대한 클라이언트 스텁 파일의 이름을 지정합니다. 자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /cstub 옵션을 참조하십시오. 또한 이 테이블의 ServerStubFile 매개 변수를 참조하십시오. |
CPreprocessOptions |
선택적 String 매개 변수입니다. C/C++ 전처리기 전달할 옵션을 지정합니다. 전처리기 옵션의 공백으로 구분된 목록을 지정합니다. 자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /cpp_opt 옵션을 참조하십시오. |
DefaultCharType |
선택적 String 매개 변수입니다. C 컴파일러는 생성된 코드를 컴파일하는 데 사용할 기본 문자 형식을 지정합니다. 각 명령줄 옵션에 해당하는 다음 값 중 하나를 지정하십시오.
값명령줄 옵션
Signed/char signed
Unsigned/char unsigned
Ascii/char ascii7
자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /char 옵션을 참조하십시오. |
DllDataFileName |
선택적 String 매개 변수입니다. 프록시 DLL에 대한 dlldata 파일의 파일 이름을 지정합니다. 자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /dlldata 옵션을 참조하십시오. |
EnableErrorChecks |
선택적 String 매개 변수입니다. 생성된 스텁을 런타임에 수행할 오류 검사 형식을 지정합니다. 각 명령줄 옵션에 해당하는 다음 값 중 하나를 지정하십시오.
값명령줄 옵션
None/error none
EnableCustom/error
All/error all
자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /error 옵션을 참조하십시오. |
ErrorCheckAllocations |
선택적 Boolean 매개 변수입니다. true인 경우 메모리 부족 오류를 확인합니다. 자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /error allocation 옵션을 참조하십시오. |
ErrorCheckBounds |
선택적 Boolean 매개 변수입니다. true인 경우 전송 길이 사양에 대해 호환 변경과 다양한 배열의 크기를 확인합니다. 자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /error bounds_check 옵션을 참조하십시오. |
ErrorCheckEnumRange |
선택적 Boolean 매개 변수입니다. true인 경우 열거형 값이 허용 가능한 범위 내에 있는지 확인합니다. 자세한 내용은 midl.exe에 대한 명령줄 도움말(/?)의 /error enum 옵션을 참조하십시오. |
ErrorCheckRefPointers |
선택적 Boolean 매개 변수입니다. true인 경우 null 참조 포인터가 클라이언트 스텁으로 전달되지 않았는지 확인합니다. 자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /error ref 옵션을 참조하십시오. |
ErrorCheckStubData |
선택적 Boolean 매개 변수입니다. true인 경우 서버 쪽에서 역마샬링 예외를 포착하는 스텁을 생성하고 이를 클라이언트에 다시 전달합니다. 자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /error stub_data 옵션을 참조하십시오. |
GenerateClientFiles |
선택적 String 매개 변수입니다. 컴파일러에서 RPC 인터페이스에 대한 클라이언트 쪽 C 소스 파일을 생성할지 여부를 지정합니다. 각 명령줄 옵션에 해당하는 다음 값 중 하나를 지정하십시오.
값명령줄 옵션
None/client none
Stub/client stub
자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /client 옵션을 참조하십시오. |
GenerateServerFiles |
선택적 String 매개 변수입니다. 컴파일러에서 RPC 인터페이스에 대한 서버 쪽 C 소스 파일을 생성할지 여부를 지정합니다. 각 명령줄 옵션에 해당하는 다음 값 중 하나를 지정하십시오.
값명령줄 옵션
None/server none
Stub/server stub
자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /server 옵션을 참조하십시오. |
GenerateStublessProxies |
선택적 Boolean 매개 변수입니다. true인 경우 개체 인터페이스를 위해 스텁 없는 프록시와 함께 완벽하게 통합된 스텁을 생성합니다. 자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /Oicf 옵션을 참조하십시오. |
GenerateTypeLibrary |
선택적 Boolean 매개 변수입니다. true인 경우 형식 라이브러리(.tlb) 파일이 생성되지 않습니다. 자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /notlb 옵션을 참조하십시오. |
HeaderFileName |
선택적 String 매개 변수입니다. 생성된 헤더 파일의 이름을 지정합니다. 자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /h 또는 /header 옵션을 참조하십시오. |
IgnoreStandardIncludePath |
선택적 Boolean 매개 변수입니다. true인 경우 MIDL 작업은 AdditionalIncludeDirectories 스위치를 사용하여 지정된 디렉터리만 검색하며 현재 디렉터리와 INCLUDE 환경 변수에 지정된 디렉터리는 무시합니다. 자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /no_def_idir 옵션을 참조하십시오. |
InterfaceIdentifierFileName |
선택적 String 매개 변수입니다. COM 인터페이스에 대한 인터페이스 식별자 파일의 이름을 지정합니다. "_i.c"를 IDL 파일 이름에 추가하여 얻은 기본 이름을 재정의합니다. 자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /iid 옵션을 참조하십시오. |
LocaleID |
선택적 int 매개 변수입니다. 입력 파일, 파일 이름 및 디렉터리 경로에서 국제 문자를 사용할 수 있는 로캘 식별자를 지정합니다. 10진수 로캘 식별자를 지정합니다. 자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /lcid 옵션을 참조하십시오. MSDN의 "Locale IDs Assigned by Microsoft"를 참조하십시오. |
MkTypLibCompatible |
선택적 Boolean 매개 변수입니다. true인 경우 입력 파일의 형식이 mktyplib.exe 버전 2.03과 호환되어야 합니다. 자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /mktyplib203 옵션을 참조하십시오. MSDN 웹 사이트의 "ODL File Syntax"를 참조하십시오. |
OutputDirectory |
선택적 String 매개 변수입니다. MIDL 작업이 출력 파일을 기록하는 기본 디렉터리를 지정합니다. 자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /out 옵션을 참조하십시오. |
PreprocessorDefinitions |
선택적 String[] 매개 변수입니다. 하나 이상의 정의를 지정합니다. 즉, #define 지시문에 의한 것처럼 C 전처리기에 전달할 이름 및 옵션 값입니다. 각 정의의 양식은 name[=value]입니다. 자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /D 옵션을 참조하십시오. 또한 이 테이블의 UndefinePreprocessorDefinitions 매개 변수를 참조하십시오. |
ProxyFileName |
선택적 String 매개 변수입니다. COM 인터페이스에 대한 인터페이스 프록시 파일의 이름을 지정합니다. 자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /proxy 옵션을 참조하십시오. |
RedirectOutputAndErrors |
선택적 String 매개 변수입니다. 오류 메시지와 경고 같은 출력을 표준 출력에서 지정된 파일로 리디렉션합니다. 자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /o 옵션을 참조하십시오. |
ServerStubFile |
선택적 String 매개 변수입니다. RPC 인터페이스에 대한 서버 스텁 파일의 이름을 지정합니다. 자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /sstub 옵션을 참조하십시오. 또한 이 테이블의 ClientStubFile 매개 변수를 참조하십시오. |
Source |
필수적 ITaskItem[] 매개 변수입니다. 공백으로 구분된 소스 파일 목록을 지정합니다. |
StructMemberAlignment |
선택적 String 매개 변수입니다. 대상 시스템에서 구조의 맞춤(패키지 수준)을 지정합니다. 각 명령줄 옵션에 해당하는 다음 값 중 하나를 지정하십시오.
값명령줄 옵션
NotSet<none>
1/Zp1
2/Zp2
4/Zp4
8/Zp8
자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /Zp 옵션을 참조하십시오. /Zp 옵션은 /pack 옵션 및 레거시 /align 옵션과 동일합니다. |
SuppressCompilerWarnings |
선택적 Boolean 매개 변수입니다. true인 경우 MIDL 작업에서 경고 메시지를 표시하지 않습니다. 자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /no_warn 옵션을 참조하십시오. |
SuppressStartupBanner |
선택적 Boolean 매개 변수입니다. true인 경우 작업을 시작할 때 저작권과 버전 번호 메시지가 표시되지 않도록 합니다. 자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /nologo 옵션을 참조하십시오. |
TargetEnvironment |
선택적 String 매개 변수입니다. 응용 프로그램이 실행되는 환경을 지정합니다. 각 명령줄 옵션에 해당하는 다음 값 중 하나를 지정하십시오.
값명령줄 옵션
NotSet<none>
Win32/env win32
Itanium/env ia64
X64/env x64
자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /env 옵션을 참조하십시오. |
TrackerLogDirectory |
선택적 String 매개 변수입니다. 이 작업에 대한 추적 로그가 저장되는 중간 디렉터리를 지정합니다. |
TypeLibFormat |
선택적 String 매개 변수입니다. 형식 라이브러리 파일의 형식을 지정합니다. 각 명령줄 옵션에 해당하는 다음 값 중 하나를 지정하십시오.
값명령줄 옵션
NewFormat/newtlb
OldFormat/oldtlb
자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /newtlb 및 /oldtlb 옵션을 참조하십시오. |
TypeLibraryName |
선택적 String 매개 변수입니다. 형식 라이브러리 파일의 이름을 지정합니다. 자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /tlb 옵션을 참조하십시오. |
UndefinePreprocessorDefinitions |
선택적 String[] 매개 변수입니다. #undefine 지시문에 의해 C 전처리기에 이름을 전달하여 이름의 이전 정의를 제거합니다. 이전에 정의된 이름을 하나 이상 지정합니다. 자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /U 옵션을 참조하십시오. 또한 이 테이블의 PreprocessorDefinitions 매개 변수를 참조하십시오. |
ValidateAllParameters |
선택적 Boolean 매개 변수입니다. true인 경우 런타임에 무결성 검사를 수행하는 데 사용되는 추가 오류 검사 정보를 생성합니다. false인 경우 오류 검사 정보가 생성되지 않습니다. 자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /robust 및 /no_robust 옵션을 참조하십시오. |
WarnAsError |
선택적 Boolean 매개 변수입니다. true이면 모든 경고를 오류로 취급합니다. WarningLevel MIDL 작업 매개 변수를 지정하지 않으면 기본 수준인 수준 1의 경고가 오류로 취급됩니다. 자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /WX 옵션을 참조하십시오. 또한 이 테이블의 WarningLevel 매개 변수를 참조하십시오. |
WarningLevel |
선택적 String 매개 변수입니다. 심각도(경고 수준) 경고를 생성하도록 지정합니다. 값이 0인 경우 아무런 경고가 생성되지 않습니다. 그렇지 않으면 경고 수준이 숫자로 지정된 값보다 작거나 같은 경우 경고를 표시합니다. 각 명령줄 옵션에 해당하는 다음 값 중 하나를 지정하십시오.
값명령줄 옵션
0/W0
1/W1
2/W2
3/W3
4/W4
자세한 내용은 MSDN 웹 사이트의 "MIDL Command-Line Reference"에서 /W 옵션을 참조하십시오. 또한 이 테이블의 WarnAsError 매개 변수를 참조하십시오. |