/WHOLEARCHIVE(모든 라이브러리 개체 파일 포함)

  • 아티클

링커가 연결된 실행 파일의 정적 라이브러리에 있는 모든 개체 파일을 포함하도록 합니다.

구문

/WHOLEARCHIVE
/WHOLEARCHIVE:library

인수

library
정적 라이브러리에 대한 선택적 경로 이름입니다. 링커는 이 라이브러리의 모든 개체 파일을 포함합니다.

설명

/WHOLEARCHIVE 옵션을 사용하면 링커가 지정된 정적 라이브러리의 모든 개체 파일을 포함하거나 라이브러리가 지정되지 않은 경우 LINK 명령에 지정된 모든 정적 라이브러리를 포함하도록 합니다. 여러 라이브러리에 대해 /WHOLEARCHIVE 옵션을 지정하려면 링커 명령줄에서 두 개 이상의 /WHOLEARCHIVE 스위치를 사용할 수 있습니다. 기본적으로 링커는 실행 파일의 다른 개체 파일에서 참조하는 기호를 내보내는 경우에만 연결된 출력에 개체 파일을 포함합니다. /WHOLEARCHIVE 옵션을 사용하면 링커가 정적 라이브러리에 보관된 모든 개체 파일을 링커 명령줄에 개별적으로 지정된 것처럼 처리합니다.

/WHOLEARCHIVE 옵션을 사용하여 정적 라이브러리에서 모든 기호를 다시 내보낼 수 있습니다. 이렇게 하면 둘 이상의 정적 라이브러리에서 구성 요소를 만들 때 모든 라이브러리 코드, 리소스 및 메타데이터가 포함되도록 할 수 있습니다. 내보낼 Windows 런타임 구성 요소가 포함된 정적 라이브러리를 만들 때 경고 LNK4264 표시되는 경우 해당 라이브러리를 다른 구성 요소 또는 앱에 연결할 때 /WHOLEARCHIVE 옵션을 사용합니다.

/WHOLEARCHIVE 옵션은 Visual Studio 2015 업데이트 2에서 도입되었습니다.

Visual Studio에서 이 링커 옵션을 설정하려면

  1. 프로젝트 속성 페이지 대화 상자를 엽니다. 자세한 내용은 Visual Studio에서 컴파일러 및 빌드 속성 설정을 참조합니다.

  2. 구성 속성>링커>명령줄 속성 페이지를 선택합니다.

  3. /WHOLEARCHIVE 추가 옵션 텍스트 상자에 옵션을 추가합니다.

참고 항목

MSVC 링커 참조
MSVC 링커 옵션