/WHOLEARCHIVE (incluir todos os arquivos-objeto da biblioteca)

  • Artigo

Force o vinculador a incluir todos os arquivos-objeto na biblioteca estática no executável vinculado.

Sintaxe

/WHOLEARCHIVE
/WHOLEARCHIVE:library

Argumentos

biblioteca
Um nome de caminho opcional para uma biblioteca estática. O vinculador inclui todos os arquivos-objeto desta biblioteca.

Comentários

A opção /WHOLEARCHIVE força o vinculador a incluir todos os arquivos-objeto de uma biblioteca estática especificada ou, se nenhuma biblioteca for especificada, de todas as bibliotecas estáticas especificadas para o comando LINK. Para especificar a opção /WHOLEARCHIVE para várias bibliotecas, você pode usar mais de uma opção /WHOLEARCHIVE na linha de comando do vinculador. Por padrão, o vinculador inclui arquivos-objeto na saída vinculada somente se eles exportarem símbolos referenciados por outros arquivos-objeto no executável. A opção /WHOLEARCHIVE faz com que o vinculador trate todos os arquivos-objeto arquivados em uma biblioteca estática como se fossem especificados individualmente na linha de comando do vinculador.

A opção /WHOLEARCHIVE pode ser usada para exportar novamente todos os símbolos de uma biblioteca estática. Isso permite que você verifique se todos os códigos, recursos e metadados de biblioteca estão incluídos quando você cria um componente de mais de uma biblioteca estática. Se você vir um aviso LNK4264 ao criar uma biblioteca estática que contém componentes do Windows Runtime para exportação, use a opção /WHOLEARCHIVE ao vincular essa biblioteca a outro componente ou aplicativo.

A opção /WHOLEARCHIVE foi introduzida no Visual Studio 2015 Atualização 2.

Para definir essa opção do vinculador no Visual Studio

  1. Abra a caixa de diálogo Páginas de Propriedades do projeto. Para obter mais informações, confira Definir as propriedades de build e do compilador do C++ no Visual Studio.

  2. Selecione a página de propriedades Propriedades da Configuração>Vinculador>Linha de Comando.

  3. Adicione a opção /WHOLEARCHIVE à caixa de texto Opções Adicionais.

Confira também

Referência de vinculador MSVC
Opções de vinculador MSVC