다음을 통해 공유


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 매개 변수를 참조하십시오.

참고 항목

기타 리소스

MSBuild 작업 참조