/ENTRY (símbolo do ponto de entrada)

  • Artigo
/ENTRY:function

Argumentos

function
Uma função que especifica um endereço inicial definido pelo usuário para um arquivo .exe ou DLL.

Comentários

A opção /ENTRY especifica uma função de ponto de entrada como o endereço inicial para um arquivo .exe ou uma DLL.

A função deve ser definida para usar a convenção de chamada __stdcall. Os parâmetros e o valor retornado variam se o programa for um aplicativo de console, um aplicativo do Windows ou uma DLL. É recomendável que você deixe o vinculador definir o ponto de entrada para que a biblioteca de runtime do C seja inicializada corretamente e que os construtores do C++ para objetos estáticos sejam executados.

Por padrão, o endereço inicial é um nome de função da biblioteca de runtime do C. O vinculador o seleciona de acordo com os atributos do programa, conforme mostrado na tabela a seguir.

Nome da função Padrão para
mainCRTStartup (ou wmainCRTStartup) Um aplicativo que usa /SUBSYSTEM:CONSOLE; chama main (ou wmain)
WinMainCRTStartup (ou wWinMainCRTStartup) Um aplicativo que usa /SUBSYSTEM:WINDOWS; chama WinMain (ou wWinMain), que devem ser definidas para usar __stdcall
_DllMainCRTStartup Uma DLL; chama DllMain se existir, que deve ser definida para usar __stdcall

Se a opção /DLL ou /SUBSYSTEM não for especificada, o vinculador selecionará um subsistema e um ponto de entrada, se main ou WinMain estiver definido.

As funções main, WinMain e DllMain são três formas do ponto de entrada definido pelo usuário.

Ao criar uma imagem gerenciada, a função especificada para /ENTRY deve ter uma assinatura de (LPVOID var1, DWORD var2, LPVOID var3).

Para obter informações sobre como definir seu próprio ponto de entrada de DllMain, confira Comportamento da biblioteca de runtime do Visual C++ e DLLs.

Para definir esta opção do vinculador no ambiente de desenvolvimento do Visual Studio

  1. Abra a caixa de diálogo Páginas de Propriedades do projeto. Para obter detalhes, 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>Avançado.

  3. Modifique a propriedade Ponto de Entrada.

Para definir esta opção do vinculador por meio de programação

Confira também

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