CL 작업CL Task

Visual C++ 컴파일러 도구 cl.exe를 래핑합니다.Wraps the Visual C++ compiler tool, cl.exe. 컴파일러는 실행(.exe) 파일, 동적 연결 라이브러리(.dll) 파일 또는 코드 모듈(.netmodule) 파일을 생성합니다.The compiler produces executable (.exe) files, dynamic-link library (.dll) files, or code module (.netmodule) files. 자세한 내용은 컴파일러 옵션을 참조하세요.For more information, see Compiler Options.

매개 변수Parameters

다음 표에서는 CL 작업의 매개 변수에 대해 설명합니다.The following table describes the parameters of the CL task. 대부분의 작업 매개 변수 및 몇 가지 매개 변수 집합은 명령줄 옵션에 해당합니다.Most task parameters, and a few sets of parameters, correspond to a command-line option.

  • AdditionalIncludeDirectoriesAdditionalIncludeDirectories

    선택적 String[] 매개 변수입니다.Optional String[] parameter.

    포함 파일을 검색할 디렉터리 목록에 디렉터리를 추가합니다.Adds a directory to the list of directories that are searched for include files.

    자세한 내용은 /I(추가 포함 디렉터리)를 참조하세요.For more information, see /I (Additional Include Directories).

  • AdditionalOptionsAdditionalOptions

    선택적 문자열 매개 변수입니다.Optional String parameter.

    명령줄 옵션의 목록입니다.A list of command-line options. 예를 들어 "/option1 /option2 /option#"과 같습니다.For example, "/option1 /option2 /option#". 이 매개 변수를 사용하여 다른 작업 매개 변수로 표현되지 않는 명령줄 옵션을 지정합니다.Use this parameter to specify command-line options that are not represented by any other task parameter.

    자세한 내용은 컴파일러 옵션을 참조하세요.For more information, see Compiler Options.

  • AdditionalUsingDirectories선택적 String[] 매개 변수입니다.AdditionalUsingDirectoriesOptional String[] parameter.

    #using 지시문에 전달된 파일 참조를 확인하기 위해 컴파일러가 검색할 디렉터리를 지정합니다.Specifies a directory that the compiler will search to resolve file references passed to the #using directive.

    자세한 내용은 /AI(메타데이터 디렉터리 지정)를 참조하세요.For more information, see /AI (Specify Metadata Directories).

  • AlwaysAppendAlwaysAppend

    선택적 문자열 매개 변수입니다.Optional String parameter.

    명령줄에 항상 내보내지는 문자열입니다.A string that always gets emitted on the command line. 기본값은 "/c"입니다.Its default value is "/c".

  • AssemblerListingLocationAssemblerListingLocation

    어셈블리 코드가 포함된 목록 파일을 만듭니다.Creates a listing file that contains assembly code.

    자세한 내용은 /FA, /Fa(목록 파일)/Fa 옵션을 참조하세요.For more information, see the /Fa option in /FA, /Fa (Listing File).

  • AssemblerOutputAssemblerOutput

    선택적 문자열 매개 변수입니다.Optional String parameter.

    어셈블리 코드가 포함된 목록 파일을 만듭니다.Creates a listing file that contains assembly code.

    각 명령줄 옵션에 해당하는 다음 값 중 하나를 지정하세요.Specify one of the following values, each of which corresponds to a command-line option.

    • NoListing - <없음>NoListing - <none>

    • AssemblyCode - /FAAssemblyCode - /FA

    • AssemblyAndMachineCode - /FAcAssemblyAndMachineCode - /FAc

    • AssemblyAndSourceCode - /FAsAssemblyAndSourceCode - /FAs

    • All - /FAcsAll - /FAcs

      자세한 내용은 /FA, /Fa(목록 파일)/FA, /FAc, /FAs/FAcs 옵션을 참조하세요.For more information, see the /FA, /FAc, /FAs, and /FAcs options in /FA, /Fa (Listing File).

  • BasicRuntimeChecksBasicRuntimeChecks

    선택적 문자열 매개 변수입니다.Optional String parameter.

    runtime_checks pragma와 함께 런타임 오류 검사 기능을 사용하거나 사용하지 않도록 설정합니다.Enables and disables the run-time error checks feature, in conjunction with the runtime_checks pragma.

    각 명령줄 옵션에 해당하는 다음 값 중 하나를 지정하세요.Specify one of the following values, each of which corresponds to a command-line option.

    • 기본값 - <없음>Default - <none>

    • StackFrameRuntimeCheck - /RTCsStackFrameRuntimeCheck - /RTCs

    • UninitializedLocalUsageCheck - /RTCuUninitializedLocalUsageCheck - /RTCu

    • EnableFastChecks - /RTC1EnableFastChecks - /RTC1

      자세한 내용은 /RTC(런타임 오류 검사)를 참조하세요.For more information, see /RTC (Run-Time Error Checks).

  • BrowseInformationBrowseInformation

    선택적 부울 매개 변수입니다.Optional Boolean parameter.

    true인 경우 찾아보기 정보 파일을 만듭니다.If true, creates a browse information file.

    자세한 내용은 /FR, /Fr(.Sbr 파일 만들기)/FR 옵션을 참조하세요.For more information, see the /FR option in /FR, /Fr (Create .Sbr File).

  • BrowseInformationFileBrowseInformationFile

    선택적 문자열 매개 변수입니다.Optional String parameter.

    찾아보기 정보 파일에 대한 파일 이름을 지정합니다.Specifies a file name for the browse information file.

    자세한 내용은 이 표의 BrowseInformation 매개 변수를 참조하고 /FR, /Fr(.Sbr 파일 만들기)도 참조하세요.For more information, see the BrowseInformation parameter in this table, and also see /FR, /Fr (Create .Sbr File).

  • BufferSecurityCheckBufferSecurityCheck

    선택적 부울 매개 변수입니다.Optional Boolean parameter.

    true인 경우 버퍼 크기 제한을 적용하지 않는 코드를 악용하기 위한 일반적인 기술인, 반환 주소를 덮어쓰는 일부 버퍼 오버런을 검색합니다.If true, detects some buffer overruns that overwrite the return address, a common technique for exploiting code that does not enforce buffer size restrictions.

    자세한 내용은 /GS(버퍼 보안 검사)를 참조하세요.For more information, see /GS (Buffer Security Check).

  • BuildingInIDEBuildingInIDE

    선택적 부울 매개 변수입니다.Optional Boolean parameter.

    true인 경우 MSBuild가 IDE에 의해 호출됨을 나타냅니다.If true, indicates that MSBuild is invoked by the IDE. 그렇지 않으면 MSBuild가 명령줄에서 호출됩니다.Otherwise, MSBuild is invoked on the command line.

  • CallingConventionCallingConvention

    선택적 문자열 매개 변수입니다.Optional String parameter.

    함수 인수가 스택으로 푸시되는 순서, 호출자 함수 또는 호출된 함수가 호출의 끝에 있는 스택에서 인수를 제거하는지 여부 및 컴파일러가 개별 함수를 식별하는 데 사용하는 이름 데코레이팅 규칙을 결정하는 호출 규칙을 지정합니다.Specifies the calling convention, which determines the order in which function arguments are pushed onto the stack, whether the caller function or called function removes the arguments from the stack at the end of the call, and the name-decorating convention that the compiler uses to identify individual functions.

    각 명령줄 옵션에 해당하는 다음 값 중 하나를 지정하세요.Specify one of the following values, each of which corresponds to a command-line option.

  • CompileAsCompileAs

    선택적 문자열 매개 변수입니다.Optional String parameter.

    입력 파일을 C 또는 C++ 소스 파일로 컴파일할지 지정합니다.Specifies whether to compile the input file as a C or C++ source file.

    각 명령줄 옵션에 해당하는 다음 값 중 하나를 지정하세요.Specify one of the following values, each of which corresponds to a command-line option.

  • CompileAsManagedCompileAsManaged

    선택적 문자열 매개 변수입니다.Optional String parameter.

    응용 프로그램 및 구성 요소가 CLR(공용 언어 런타임)의 기능을 사용할 수 있게 합니다.Enables applications and components to use features from the common language runtime (CLR).

    각 명령줄 옵션에 해당하는 다음 값 중 하나를 지정하세요.Specify one of the following values, each of which corresponds to a command-line option.

  • CreateHotpatchableImageCreateHotpatchableImage

    선택적 부울 매개 변수입니다.Optional Boolean parameter.

    true인 경우 컴파일러가 핫 패치용 이미지를 준비하도록 합니다.If true, tells the compiler to prepare an image for hot patching. 이 매개 변수는 각 함수의 첫 번째 명령이 2바이트가 되도록 합니다(핫 패치에 필요함).This parameter ensures that the first instruction of each function is two bytes, which is required for hot patching.

    자세한 내용은 /hotpatch(핫 패치 가능 이미지 만들기)를 참조하세요.For more information, see /hotpatch (Create Hotpatchable Image).

  • DebugInformationFormatDebugInformationFormat

    선택적 문자열 매개 변수입니다.Optional String parameter.

    프로그램용으로 생성되는 디버깅 정보 형식과 이 정보를 개체(.obj) 파일에 유지할지 아니면 프로그램 데이터베이스(PDB)에 유지할지를 선택합니다.Selects the type of debugging information created for your program and whether this information is kept in object (.obj) files or in a program database (PDB).

    각 명령줄 옵션에 해당하는 다음 값 중 하나를 지정하세요.Specify one of the following values, each of which corresponds to a command-line option.

  • DisableLanguageExtensionsDisableLanguageExtensions

    선택적 부울 매개 변수입니다.Optional Boolean parameter.

    true인 경우 컴파일러가 ANSI C 또는 ANSI C++와 호환되지 않는 언어 구문에 대한 오류를 내보내도록 합니다.If true, tells the compiler to emit an error for language constructs that are not compatible with either ANSI C or ANSI C++.

    자세한 내용은 /Za, /Ze(언어 확장 사용 안 함)/Za 옵션을 참조하세요.For more information, see the /Za option in /Za, /Ze (Disable Language Extensions).

  • DisableSpecificWarningsDisableSpecificWarnings

    선택적 String[] 매개 변수입니다.Optional String[] parameter.

    세미콜론으로 구분된 목록에 지정된 경고 번호를 사용하지 않도록 설정합니다.Disables the warning numbers that are specified in a semicolon-delimited list.

    자세한 내용은 /w, /W0, /W1, /W2, /W3, /W4, /w1, /w2, /w3, /w4, /Wall, /wd, /we, /wo, /Wv, /WX(경고 수준)/wd 옵션을 참조하세요.For more information, see the /wd option in /w, /W0, /W1, /W2, /W3, /W4, /w1, /w2, /w3, /w4, /Wall, /wd, /we, /wo, /Wv, /WX (Warning Level).

  • EnableEnhancedInstructionSetEnableEnhancedInstructionSet

    선택적 문자열 매개 변수입니다.Optional String parameter.

    SSE(스트리밍 SIMD 확장) 및 SSE2(스트리밍 SIMD 확장 2) 명령을 사용하는 코드 생성에 대한 아키텍처를 지정합니다.Specifies the architecture for code generation that uses the Streaming SIMD Extensions (SSE) and Streaming SIMD Extensions 2 (SSE2) instructions.

    각 명령줄 옵션에 해당하는 다음 값 중 하나를 지정하세요.Specify one of the following values, each of which corresponds to a command-line option.

    • StreamingSIMDExtensions - /arch:SSEStreamingSIMDExtensions - /arch:SSE

    • StreamingSIMDExtensions2 - /arch:SSE2StreamingSIMDExtensions2 - /arch:SSE2

      자세한 내용은 /arch(x86)를 참조하세요.For more information, see /arch (x86).

  • EnableFiberSafeOptimizationsEnableFiberSafeOptimizations

    선택적 부울 매개 변수입니다.Optional Boolean parameter.

    true인 경우 정적 스레드 로컬 저장소를 사용하여 할당한 데이터(즉, __declspec(thread)를 사용하여 할당한 데이터)의 파이버 안전을 지원합니다.If true, support fiber safety for data allocated by using static thread-local storage, that is, data allocated by using __declspec(thread).

    자세한 내용은 /GT(파이버 안전 스레드 로컬 저장소 지원)를 참조하세요.For more information, see /GT (Support Fiber-Safe Thread-Local Storage).

  • EnablePREfastEnablePREfast

    선택적 부울 매개 변수입니다.Optional Boolean parameter.

    true인 경우 코드 분석을 사용하도록 설정합니다.If true, enable code analysis.

    자세한 내용은 /analyze(코드 분석)를 참조하세요.For more information, see /analyze (Code Analysis).

  • ErrorReportingErrorReporting

    선택적 문자열 매개 변수입니다.Optional String parameter.

    ICE(내부 컴파일러 오류) 정보를 Microsoft에 직접 제공할 수 있도록 합니다.Lets you provide internal compiler error (ICE) information directly to Microsoft. 기본적으로 IDE 빌드의 설정은 프롬프트이며, 명령줄 빌드의 설정은 입니다.By default, the setting in IDE builds is Prompt and the setting in command-line builds is Queue.

    각 명령줄 옵션에 해당하는 다음 값 중 하나를 지정하세요.Specify one of the following values, each of which corresponds to a command-line option.

  • ExceptionHandlingExceptionHandling

    선택적 문자열 매개 변수입니다.Optional String parameter.

    컴파일러가 사용하는 예외 처리 모델을 지정합니다.Specifies the model of exception handling to be used by the compiler.

    각 명령줄 옵션에 해당하는 다음 값 중 하나를 지정하세요.Specify one of the following values, each of which corresponds to a command-line option.

  • ExpandAttributedSourceExpandAttributedSource

    선택적 부울 매개 변수입니다.Optional Boolean parameter.

    true인 경우 소스 파일에 확장 특성을 삽입한 목록 파일을 만듭니다.If true, creates a listing file that has expanded attributes injected into the source file.

    자세한 내용은 /Fx(삽입된 코드 병합)를 참조하세요.For more information, see /Fx (Merge Injected Code).

  • FavorSizeOrSpeedFavorSizeOrSpeed

    선택적 문자열 매개 변수입니다.Optional String parameter.

    코드 크기나 코드 속도 중 우선하는 것을 지정합니다.Specifies whether to favor code size or code speed.

    각 명령줄 옵션에 해당하는 다음 값 중 하나를 지정하세요.Specify one of the following values, each of which corresponds to a command-line option.

  • FloatingPointExceptionsFloatingPointExceptions

    선택적 부울 매개 변수입니다.Optional Boolean parameter.

    true인 경우 안정적인 부동 소수점 예외 모델을 사용할 수 있습니다.If true, enables the reliable floating-point exception model. 예외가 트리거되는 직후 발생합니다.Exceptions will be raised immediately after they are triggered.

    자세한 내용은 /fp(부동 소수점 동작 지정)의 /fp:except 옵션을 참조하세요.For more information, see the /fp:except option in /fp (Specify Floating-Point Behavior).

  • FloatingPointModelFloatingPointModel

    선택적 문자열 매개 변수입니다.Optional String parameter.

    부동 소수점 모델을 설정합니다.Sets the floating point model.

    각 명령줄 옵션에 해당하는 다음 값 중 하나를 지정하세요.Specify one of the following values, each of which corresponds to a command-line option.

  • ForceConformanceInForLoopScopeForceConformanceInForLoopScope

    선택적 부울 매개 변수입니다.Optional Boolean parameter.

    true인 경우 Microsoft 확장(/Ze)을 사용하는 for 루프의 표준 C++ 동작을 구현합니다.If true, implements standard C++ behavior in for loops that use Microsoft extensions (/Ze).

    자세한 내용은 /Zc:forScope(for 루프 범위의 강제 규칙)를 참조하세요.For more information, see /Zc:forScope (Force Conformance in for Loop Scope).

  • ForcedIncludeFilesForcedIncludeFiles

    선택적 String[] 매개 변수입니다.Optional String[] parameter.

    전처리기가 하나 이상의 지정된 헤더 파일을 처리하게 합니다.Causes the preprocessor to process one or more specified header files.

    자세한 내용은 /FI(강제 포함 파일 이름 지정)를 참조하세요.For more information, see /FI (Name Forced Include File).

  • ForcedUsingFilesForcedUsingFiles

    선택적 String[] 매개 변수입니다.Optional String[] parameter.

    전처리기가 하나 이상의 지정된 #using 파일을 처리하게 합니다.Causes the preprocessor to process one or more specified #using files.

    자세한 내용은 /FU(강제 #using 파일 이름 지정)를 참조하세요.For more information, see /FU (Name Forced #using File).

  • FunctionLevelLinkingFunctionLevelLinking

    선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

    true인 경우 컴파일러가 개별 함수를 패키지된 함수의 형태로 패키지할 수 있습니다(COMDAT).If true, enables the compiler to package individual functions in the form of packaged functions (COMDATs).

    자세한 내용은 /Gy(함수 수준 링크 사용)를 참조하세요.For more information, see /Gy (Enable Function-Level Linking).

  • GenerateXMLDocumentationFilesGenerateXMLDocumentationFiles

    선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

    true인 경우 컴파일러가 소스 코드 파일의 문서 주석을 처리하고 문서 주석이 포함된 각 소스 코드 파일에 대한 .xdc 파일을 만들도록 합니다.If true, causes the compiler to process documentation comments in source code files and to create an .xdc file for each source code file that has documentation comments.

    자세한 내용은 /doc(문서 주석 처리)(C/C++)를 참조하세요.For more information, see /doc (Process Documentation Comments) (C/C++). 또한 이 표의 XMLDocumentationFileName 매개 변수도 참조하세요.Also see the XMLDocumentationFileName parameter in this table.

  • IgnoreStandardIncludePathIgnoreStandardIncludePath

    선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

    true인 경우 컴파일러가 PATH 및 INCLUDE 환경 변수에 지정된 디렉터리에서 포함 파일을 검색하지 않도록 합니다.If true, prevents the compiler from searching for include files in directories specified in the PATH and INCLUDE environment variables.

    자세한 내용은 /X(표준 포함 경로 무시)를 참조하세요.For more information, see /X (Ignore Standard Include Paths).

  • InlineFunctionExpansionInlineFunctionExpansion

    선택적 문자열 매개 변수입니다.Optional String parameter.

    빌드에 대한 인라인 함수 확장 수준을 지정합니다.Specifies the level of inline function expansion for the build.

    각 명령줄 옵션에 해당하는 다음 값 중 하나를 지정하세요.Specify one of the following values, each of which corresponds to a command-line option.

  • IntrinsicFunctionsIntrinsicFunctions

    선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

    true인 경우 응용 프로그램을 더 빠르게 실행하는 데 도움이 되는 내장 함수 또는 다른 특별한 형태의 함수로 일부 함수 호출을 바꿉니다.If true, replaces some function calls with intrinsic or otherwise special forms of the function that help your application run faster.

    자세한 내용은 /Oi(내장 함수 만들기)를 참조하세요.For more information, see /Oi (Generate Intrinsic Functions).

  • MinimalRebuildMinimalRebuild

    선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

    true인 경우 변경된 C++ 클래스 정의(헤더 파일(.h)에 저장됨)가 포함된 C++ 소스 파일을 다시 컴파일해야 하는지 결정하는 최소 다시 빌드를 사용하도록 설정합니다.If true, enables minimal rebuild, which determines whether C++ source files that include changed C++ class definitions (stored in header (.h) files) must be recompiled.

    자세한 내용은 /Gm(최소 다시 빌드 사용)을 참조하세요.For more information, see /Gm (Enable Minimal Rebuild).

  • MultiProcessorCompilationMultiProcessorCompilation

    선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

    true인 경우 다중 프로세서를 사용하여 컴파일합니다.If true, use multiple processors to compile. 이 매개 변수는 컴퓨터의 각 유효 프로세서에 대한 프로세스를 만듭니다.This parameter creates a process for each effective processor on your computer.

    자세한 내용은 /MP(여러 프로세스로 빌드)를 참조하세요.For more information, see /MP (Build with Multiple Processes). 또한 이 표의 ProcessorNumber 매개 변수도 참조하세요.Also, see the ProcessorNumber parameter in this table.

  • ObjectFileNameObjectFileName

    선택적 문자열 매개 변수입니다.Optional String parameter.

    기본값 대신 사용할 개체(.obj) 파일 이름 또는 디렉터리를 지정합니다.Specifies an object (.obj) file name or directory to be used instead of the default.

    자세한 내용은 /Fo(개체 파일 이름)를 참조하세요.For more information, see /Fo (Object File Name).

  • ObjectFilesObjectFiles

    선택적 String[] 매개 변수입니다.Optional String[] parameter.

    개체 파일의 목록입니다.A list of object files.

  • OmitDefaultLibNameOmitDefaultLibName

    선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

    true인 경우 개체(.obj) 파일에서 기본 C 런타임 라이브러리 이름을 생략합니다.If true, omits the default C run-time library name from the object (.obj) file. 기본적으로 컴파일러는 올바른 라이브러리로 링커를 보내기 위해 라이브러리 이름을 .obj 파일에 넣습니다.By default, the compiler puts the name of the library into the .obj file to direct the linker to the correct library.

    자세한 내용은 /Zl(기본 라이브러리 이름 생략)를 참조하세요.For more information, see /Zl (Omit Default Library Name).

  • OmitFramePointersOmitFramePointers

    선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

    true인 경우 호출 스택에서 프레임 포인터를 생성하지 않습니다.If true, suppresses creation of frame pointers on the call stack.

    자세한 내용은 /Oy(프레임 포인터 생략)를 참조하세요.For more information, see /Oy (Frame-Pointer Omission).

  • OpenMPSupportOpenMPSupport

    선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

    true인 경우 컴파일러가 OpenMP 절 및 지시문을 처리하게 합니다.If true, causes the compiler to process OpenMP clauses and directives.

    자세한 내용은 /openmp(OpenMP 2.0 지원 활성화)를 참조하세요.For more information, see /openmp (Enable OpenMP 2.0 Support).

  • OptimizationOptimization

    선택적 문자열 매개 변수입니다.Optional String parameter.

    속도 및 크기에 대한 다양한 코드 최적화를 지정합니다.Specifies various code optimizations for speed and size.

    각 명령줄 옵션에 해당하는 다음 값 중 하나를 지정하세요.Specify one of the following values, each of which corresponds to a command-line option.

  • PrecompiledHeaderPrecompiledHeader

    선택적 문자열 매개 변수입니다.Optional String parameter.

    빌드 중 미리 컴파일된 헤더(.pch) 파일을 만들거나 사용합니다.Create or use a precompiled header (.pch) file during the build.

    각 명령줄 옵션에 해당하는 다음 값 중 하나를 지정하세요.Specify one of the following values, each of which corresponds to a command-line option.

  • PrecompiledHeaderFilePrecompiledHeaderFile

    선택적 문자열 매개 변수입니다.Optional String parameter.

    만들거나 사용할 미리 컴파일된 헤더 파일 이름을 지정합니다.Specifies a precompiled header file name to create or use.

    자세한 내용은 /Yc(미리 컴파일된 헤더 파일 만들기)/Yu(미리 컴파일된 헤더 파일 사용)를 참조하세요.For more information, see /Yc (Create Precompiled Header File) and /Yu (Use Precompiled Header File).

  • PrecompiledHeaderOutputFilePrecompiledHeaderOutputFile

    선택적 문자열 매개 변수입니다.Optional String parameter.

    기본 경로 이름을 사용하는 대신 미리 컴파일된 헤더의 경로 이름을 지정합니다.Specifies a path name for a precompiled header instead of using the default path name.

    자세한 내용은 /Fp(.Pch 파일 이름 지정)를 참조하세요.For more information, see /Fp (Name .Pch File).

  • PreprocessKeepCommentsPreprocessKeepComments

    선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

    true인 경우 전처리 중 주석을 유지합니다.If true, preserves comments during preprocessing.

    자세한 내용은 /C(전처리 중에 주석 유지)를 참조하세요.For more information, see /C (Preserve Comments During Preprocessing).

  • PreprocessorDefinitionsPreprocessorDefinitions

    선택적 String[] 매개 변수입니다.Optional String[] parameter.

    소스 파일에 대한 전처리 기호를 정의합니다.Defines a preprocessing symbol for your source file.

    자세한 내용은 /D(전처리기 정의)를 참조하세요.For more information, see /D (Preprocessor Definitions).

  • PreprocessOutputPreprocessOutput

    선택적 ITaskItem[] 매개 변수입니다.Optional ITaskItem[] parameter.

    작업에서 사용하고 내보낼 수 있는 전처리기 출력 항목의 배열을 정의합니다.Defines an array of preprocessor output items that can be consumed and emitted by tasks.

  • PreprocessOutputPathPreprocessOutputPath

    선택적 String 매개 변수입니다.Optional String parameter.

    PreprocessToFile 매개 변수가 전처리된 출력을 작성할 출력 파일의 이름을 지정합니다.Specifies the name of the output file to which the PreprocessToFile parameter writes preprocessed output.

    자세한 내용은 /Fi(출력 파일 이름 전처리)를 참조하세요.For more information, see /Fi (Preprocess Output File Name).

  • PreprocessSuppressLineNumbersPreprocessSuppressLineNumbers

    선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

    true인 경우 C 및 C++소스 파일을 전처리하고, 표준 출력 장치에 전처리된 파일을 복사합니다.If true, preprocesses C and C++ source files and copies the preprocessed files to the standard output device.

    자세한 내용은 /EP(#line 지시문 없이 stdout으로 전처리)를 참조하세요.For more information, see /EP (Preprocess to stdout Without #line Directives).

  • PreprocessToFilePreprocessToFile

    선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

    true인 경우 C 및 C++ 소스 파일을 전처리하고, 전처리된 출력을 파일에 작성합니다.If true, preprocesses C and C++ source files and writes the preprocessed output to a file.

    자세한 내용은 /P(파일로 전처리)를 참조하세요.For more information, see /P (Preprocess to a File).

  • ProcessorNumberProcessorNumber

    선택적 Integer 매개 변수입니다.Optional Integer parameter.

    다중 프로세서 컴파일에서 사용할 최대 프로세서 수를 지정합니다.Specifies the maximum number of processors to use in a multiprocessor compilation. 이 매개 변수는 MultiProcessorCompilation 매개 변수와 결합하여 사용합니다.Use this parameter in combination with the MultiProcessorCompilation parameter.

  • ProgramDataBaseFileNameProgramDataBaseFileName

    선택적 String 매개 변수입니다.Optional String parameter.

    PDB(프로그램 데이터베이스) 파일에 대한 파일 이름을 지정합니다.Specifies a file name for the program database (PDB) file.

    자세한 내용은 /Fd(프로그램 데이터베이스 파일 이름)를 참조하세요.For more information, see /Fd (Program Database File Name).

  • RuntimeLibraryRuntimeLibrary

    선택적 String 매개 변수입니다.Optional String parameter.

    다중 스레드 모듈이 DLL인지 나타내고, 런타임 라이브러리의 정품 버전 또는 디버그 버전을 선택합니다.Indicates whether a multithreaded module is a DLL, and selects retail or debug versions of the run-time library.

    각 명령줄 옵션에 해당하는 다음 값 중 하나를 지정하세요.Specify one of the following values, each of which corresponds to a command-line option.

  • RuntimeTypeInfoRuntimeTypeInfo

    선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

    true인 경우 런타임에 C++ 개체의 형식(런타임 형식 정보)을 검사하는 코드를 추가합니다.If true, adds code to check C++ object types at run time (run-time type information).

    자세한 내용은 /GR(런타임 형식 정보 사용)을 참조하세요.For more information, see /GR (Enable Run-Time Type Information).

  • ShowIncludesShowIncludes

    선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

    true인 경우 컴파일러가 포함 파일의 목록을 출력하게 합니다.If true, causes the compiler to output a list of the include files.

    자세한 내용은 /showIncludes(포함 파일 나열)를 참조하세요.For more information, see /showIncludes (List Include Files).

  • SmallerTypeCheckSmallerTypeCheck

    선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

    true인 경우 값이 더 작은 데이터 형식에 할당되어 데이터 손실이 발생하면 런타임 오류를 보고합니다.If true, reports a run-time error if a value is assigned to a smaller data type and causes a data loss.

    자세한 내용은 /RTC(런타임 오류 검사)/RTCc 옵션을 참조하세요.For more information, see the /RTCc option in /RTC (Run-Time Error Checks).

  • SourcesSources

    필수 ITaskItem[] 매개 변수입니다.Required ITaskItem[] parameter.

    공백으로 구분된 소스 파일 목록을 지정합니다.Specifies a list of source files separated by spaces.

  • StringPoolingStringPooling

    선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

    true인 경우 컴파일러가 프로그램 이미지에서 동일한 문자열의 복사본 하나를 만들 수 있습니다.If true, enables the compiler to create one copy of identical strings in the program image.

    자세한 내용은 /GF(중복 문자열 제거)를 참조하세요.For more information, see /GF (Eliminate Duplicate Strings).

  • StructMemberAlignmentStructMemberAlignment

    선택적 String 매개 변수입니다.Optional String parameter.

    구조체의 모든 멤버에 대해 바이트 맞춤을 지정합니다.Specifies the byte alignment for all members in a structure.

    각 명령줄 옵션에 해당하는 다음 값 중 하나를 지정하세요.Specify one of the following values, each of which corresponds to a command-line option.

    • Default - /Zp1Default - /Zp1

    • 1Byte - /Zp11Byte - /Zp1

    • 2Bytes - /Zp22Bytes - /Zp2

    • 4Bytes - /Zp44Bytes - /Zp4

    • 8Bytes - /Zp88Bytes - /Zp8

    • 16Bytes - /Zp1616Bytes - /Zp16

      자세한 내용은 /Zp(구조체 멤버 맞춤)를 참조하세요.For more information, see /Zp (Struct Member Alignment).

  • SuppressStartupBannerSuppressStartupBanner

    선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

    true인 경우 작업을 시작할 때 저작권과 버전 번호 메시지가 표시되지 않도록 합니다.If true, prevents the display of the copyright and version number message when the task starts.

    자세한 내용은 /nologo(시작 배너 표시 안 함)(C/C++)를 참조하세요.For more information, see /nologo (Suppress Startup Banner) (C/C++).

  • TrackerLogDirectoryTrackerLogDirectory

    선택적 String 매개 변수입니다.Optional String parameter.

    이 작업에 대한 추적 로그를 저장할 중간 디렉터리를 지정합니다.Specifies the intermediate directory where tracking logs for this task are stored.

    자세한 내용은 이 표의 TLogReadFilesTLogWriteFiles 매개 변수를 참조하세요.For more information, see the TLogReadFiles and TLogWriteFiles parameters in this table.

  • TreatSpecificWarningsAsErrorsTreatSpecificWarningsAsErrors

    선택적 String[] 매개 변수입니다.Optional String[] parameter.

    지정된 컴파일러 경고 목록을 오류로 처리합니다.Treats the specified list of compiler warnings as errors.

    자세한 내용은 /w, /W0, /W1, /W2, /W3, /W4, /w1, /w2, /w3, /w4, /Wall, /wd, /we, /wo, /Wv, /WX(경고 수준)/wen 옵션을 참조하세요.For more information, see the /wen option in /w, /W0, /W1, /W2, /W3, /W4, /w1, /w2, /w3, /w4, /Wall, /wd, /we, /wo, /Wv, /WX (Warning Level).

  • TreatWarningAsErrorTreatWarningAsError

    선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

    true인 경우 모든 컴파일러 경고를 오류로 처리합니다.If true, treat all compiler warnings as errors.

    자세한 내용은 /w, /W0, /W1, /W2, /W3, /W4, /w1, /w2, /w3, /w4, /Wall, /wd, /we, /wo, /Wv, /WX(경고 수준)/WX 옵션을 참조하세요.For more information, see /WX option in /w, /W0, /W1, /W2, /W3, /W4, /w1, /w2, /w3, /w4, /Wall, /wd, /we, /wo, /Wv, /WX (Warning Level).

  • TreatWChar_tAsBuiltInTypeTreatWChar_tAsBuiltInType

    선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

    true인 경우 wchar_t 형식을 네이티브 형식으로 처리합니다.If true, treat the wchar_t type as a native type.

    자세한 내용은 /Zc:wchar_t(wchar_t는 네이티브 형식임)를 참조하세요.For more information, see /Zc:wchar_t (wchar_t Is Native Type).

  • UndefineAllPreprocessorDefinitionsUndefineAllPreprocessorDefinitions

    선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

    true인 경우 컴파일러가 정의하는 Microsoft 관련 기호를 정의 해제합니다.If true, undefines the Microsoft-specific symbols that the compiler defines.

    자세한 내용은 /U, /u(기호 정의 해제)/u 옵션을 참조하세요.For more information, see the /u option in /U, /u (Undefine Symbols).

  • UndefinePreprocessorDefinitionsUndefinePreprocessorDefinitions

    선택적 String[] 매개 변수입니다.Optional String[] parameter.

    정의 해제할 하나 이상의 전처리기 기호 목록을 지정합니다.Specifies a list of one or more preprocessor symbols to undefine.

    자세한 내용은 /U, /u(기호 정의 해제)/U 옵션을 참조하세요.For more information, see /U option in /U, /u (Undefine Symbols).

  • UseFullPathsUseFullPaths

    선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

    true인 경우 진단에서 컴파일러에 전달된 소스 코드 파일의 전체 경로를 표시합니다.If true, displays the full path of source code files passed to the compiler in diagnostics.

    자세한 내용은 /FC(진단 소스 코드 파일의 전체 경로)를 참조하세요.For more information, see /FC (Full Path of Source Code File in Diagnostics).

  • UseUnicodeForAssemblerListingUseUnicodeForAssemblerListing

    선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

    true인 경우 출력 파일을 UTF-8 형식으로 만듭니다.If true, causes the output file to be created in UTF-8 format.

    자세한 내용은 /FA, /Fa(목록 파일)/FAu 옵션을 참조하세요.For more information, see the /FAu option in /FA, /Fa (Listing File).

  • WarningLevelWarningLevel

    선택적 String 매개 변수입니다.Optional String parameter.

    컴파일러에서 생성할 가장 높은 수준의 경고를 지정합니다.Specifies the highest level of warning that is to be generated by the compiler.

    각 명령줄 옵션에 해당하는 다음 값 중 하나를 지정하세요.Specify one of the following values, each of which corresponds to a command-line option.

  • WholeProgramOptimizationWholeProgramOptimization

    선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

    true인 경우 전체 프로그램 최적화를 사용합니다.If true, enables whole program optimization.

    자세한 내용은 /GL(전체 프로그램 최적화)을 참조하세요.For more information, see /GL (Whole Program Optimization).

  • XMLDocumentationFileNameXMLDocumentationFileName

    선택적 String 매개 변수입니다.Optional String parameter.

    생성된 XML 문서 파일의 이름을 지정합니다.Specifies the name of the generated XML documentation files. 이 매개 변수는 파일 또는 디렉터리 이름일 수 있습니다.This parameter can be a file or directory name.

    자세한 내용은 /doc(문서 주석 처리)(C/C++)name 인수를 참조하세요.For more information, see the name argument in /doc (Process Documentation Comments) (C/C++). 또한 이 표의 GenerateXMLDocumentationFiles 매개 변수도 참조하세요.Also see the GenerateXMLDocumentationFiles parameter in this table.

  • MinimalRebuildFromTrackingMinimalRebuildFromTracking

    선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

    true인 경우 추적된 증분 빌드가 수행됩니다. false인 경우 다시 빌드가 수행됩니다.If true, a tracked incremental build is performed; if false, a rebuild is performed.

  • TLogReadFilesTLogReadFiles

    선택적 ITaskItem[] 매개 변수입니다.Optional ITaskItem[] parameter.

    읽기 파일 추적 로그를 나타내는 항목의 배열을 지정합니다.Specifies an array of items that represent the read file tracking logs.

    읽기 파일 추적 로그(.tlog)에는 작업에서 읽은 입력 파일의 이름이 포함되어 있으며, 프로젝트 빌드 시스템에서 증분 빌드를 지원하는 데 이 로그를 사용합니다.A read-file tracking log (.tlog) contains the names of the input files that are read by a task, and is used by the project build system to support incremental builds. 자세한 내용은 이 표의 TrackerLogDirectoryTrackFileAccess 매개 변수를 참조하세요.For more information, see the TrackerLogDirectory and TrackFileAccess parameters in this table.

  • TLogWriteFilesTLogWriteFiles

    선택적 ITaskItem[] 매개 변수입니다.Optional ITaskItem[] parameter.

    쓰기 파일 추적 로그를 나타내는 항목의 배열을 지정합니다.Specifies an array of items that represent the write file tracking logs.

    쓰기 파일 추적 로그(.tlog)에는 작업에서 작성한 출력 파일의 이름이 포함되어 있으며, 프로젝트 빌드 시스템에서 증분 빌드를 지원하는 데 이 로그를 사용합니다.A write-file tracking log (.tlog) contains the names of the output files that are written by a task, and is used by the project build system to support incremental builds. 자세한 내용은 이 표의 TrackerLogDirectoryTrackFileAccess 매개 변수를 참조하세요.For more information, see the TrackerLogDirectory and TrackFileAccess parameters in this table.

  • TrackFileAccessTrackFileAccess

    선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

    true인 경우 파일 액세스 패턴을 추적합니다.If true, tracks file access patterns.

    자세한 내용은 이 표의 TLogReadFilesTLogWriteFiles 매개 변수를 참조하세요.For more information, see the TLogReadFiles and TLogWriteFiles parameters in this table.

설명Remarks

참고 항목See Also

작업 참조Task Reference