Platform Toolset 설정에 따른 Visual C++의 헤더 파일 기본 디렉터리

"Platform Toolset"을 "Visual Studio 2017 (v141)"로 설정이 되면 기본적으로 다음의 디렉터리들이 include 폴더 대상이 됩니다.

C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\VC\Tools\MSVC\14.12.25827\include
C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\VC\Tools\MSVC\14.12.25827\atlmfc\include
C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\VC\Auxiliary\VS\include
C:\Program Files (x86)\Windows Kits\10\Include\10.0.16299.0\ucrt
C:\Program Files (x86)\Windows Kits\10\Include\10.0.16299.0\um
C:\Program Files (x86)\Windows Kits\10\Include\10.0.16299.0\shared
C:\Program Files (x86)\Windows Kits\10\Include\10.0.16299.0\winrt
C:\Program Files (x86)\Windows Kits\NETFXSDK\4.7.1\Include\um

위의 디렉터리들은 사실 다음과 같은 변수로 할당되어 있는데,

$(VC_IncludePath) = C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\VC\Tools\MSVC\14.12.25827\include
                    C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\VC\Tools\MSVC\14.12.25827\atlmfc\include
                    C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\VC\Auxiliary\VS\include
                    C:\Program Files (x86)\Windows Kits\10\Include\10.0.16299.0\ucrt

$(WindowsSDK_IncludePath) = C:\Program Files (x86)\Windows Kits\10\Include\10.0.16299.0\um
                            C:\Program Files (x86)\Windows Kits\10\Include\10.0.16299.0\shared
                            C:\Program Files (x86)\Windows Kits\10\Include\10.0.16299.0\winrt
                            C:\Program Files (x86)\Windows Kits\NETFXSDK\4.7.1\Include\um

결국 Visual Studio 2017에서 C++ 프로젝트를 생성하는 경우에는 기본적으로 다음과 같은 헤더 폴더 경로가 설정된 것으로 시작합니다.

$(VC_IncludePath)
$(WindowsSDK_IncludePath)

그런데 만약 "Platform Toolset"을 다른 값, 예를 들어 "Visual Studio 2015 - Windows XP (v140_xp)"로 바꾸면 헤더 파일을 위한 기본 디렉터리가 다음과 같이 바뀝니다.

C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\include
C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\atlmfc\include
C:\Program Files (x86)\Windows Kits\10\Include\10.0.10240.0\ucrt
C:\Program Files (x86)\Microsoft SDKs\Windows\v7.1A\include

역시 이것도 다음의 변수에 각각 할당된 것들입니다.

$(WindowsSdk_71A_IncludePath) = C:\Program Files (x86)\Microsoft SDKs\Windows\v7.1A\include

$(VC_IncludePath) = C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\include
                    C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\atlmfc\include
                    C:\Program Files (x86)\Windows Kits\10\Include\10.0.10240.0\ucrt

참고로, WindowsSdk_71A_IncludePath와 WindowsSDK_IncludePath 변수들은 해당 플랫폼 툴셋이 정의된 경우에만 정상적인 경로를 갖습니다.

---

주의해야 할 사항이 있다면, 이전 버전의 Visual Studio에서 생성한 Visual C++ 프로젝트를 2017 버전으로 마이그레이션하는 경우 헤더 파일을 위한 기본 디렉터리가 자동으로 바뀌지는 않는다는 점입니다.

즉, 기존 프로젝트가 "Visual Studio 2015 - Windows XP (v140_xp)"로 설정되어 있으면 그 프로젝트를 (마이그레이션 없이) 2017 버전에서 여는 경우 기본 디렉터리가 $(VC_IncludePath), $(WindowsSDK_IncludePath)로 바뀌지 않습니다.

---

[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]

[최초 등록일: 1/17/2018]
[최종 수정일: 8/26/2024]


이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.

by SeongTae Jeong, mailto:techsharer at outlook.com