/WHOLEARCHIVE (Incluir todos los archivos de objetos de biblioteca)

Fuerce al enlazador a incluir todos los archivos de objeto en la biblioteca estática en el ejecutable vinculado.

Syntax

/WHOLEARCHIVE
/WHOLEARCHIVE:library

Argumentos

Biblioteca
Un nombre de ruta de acceso opcional a una biblioteca estática. El vinculador incluye todos los archivos de objeto de esta biblioteca.

Notas

La opción /WHOLEARCHIVE obliga al vinculador a incluir todos los archivos de objeto de una biblioteca estática especificada, o si no se especifica ninguna biblioteca, de todas las bibliotecas estáticas especificadas al comando LINK. Para especificar la opción /WHOLEARCHIVE para varias bibliotecas, puede usar más de un modificador /WHOLEARCHIVE en la línea de comandos del vinculador. De forma predeterminada, el enlazador incluye archivos de objeto en la salida vinculada solo si exportan símbolos a los que hacen referencia otros archivos de objeto en el archivo ejecutable. La opción /WHOLEARCHIVE hace que el vinculador trate todos los archivos de objeto archivados en una biblioteca estática como si se hubieran especificado individualmente en la línea de comandos del vinculador.

La opción /WHOLEARCHIVE se puede usar para volver a exportar todos los símbolos de una biblioteca estática. Esto le permite asegurarse de que todo el código, los recursos y los metadatos de la biblioteca se incluyen al crear un componente a partir de más de una biblioteca estática. Si ve la advertencia LNK4264 al crear una biblioteca estática que contiene componentes de Windows Runtime para exportar, use la opción /WHOLEARCHIVE al vincular esa biblioteca a otro componente o aplicación.

La opción /WHOLEARCHIVE se introdujo en Visual Studio 2015 Update 2.

Para establecer esta opción del vinculador en Visual Studio

  1. Abra el cuadro de diálogo Páginas de propiedades del proyecto. Para más información, vea Establecimiento del compilador de C++ y de propiedades de compilación en Visual Studio.

  2. Seleccione la página de propiedades Propiedades de configuración>Enlazador>Línea de comandos.

  3. Agregue la /WHOLEARCHIVE opción al cuadro de texto Opciones adicionales.

Vea también

Referencia del enlazador MSVC
Opciones del enlazador MSVC