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