Partilhar via


dllMainReturnsFalse MDA

Nota

Este artigo é específico do .NET Framework. Ele não se aplica a implementações mais recentes do .NET, incluindo o .NET 6 e versões posteriores.

O dllMainReturnsFalse assistente de depuração gerenciado (MDA) é ativado se a função gerenciada DllMain de um assembly de usuário, chamado com razão DLL_PROCESS_ATTACH, retorna FALSE.

Sintomas

A DllMain função retornou FALSE, indicando que não foi executada corretamente. Isso pode causar problemas indeterminados porque DllMain as funções geralmente contêm código de inicialização importante.

Motivo

A DllMain função é chamada com razão DLL_PROCESS_ATTACH para inicialização de DLL após o carregamento. Se ele retornar FALSE, isso significa que a inicialização da DLL falhou.

Resolução

Analise o DllMain código da função da DLL com falha e identifique a causa da falha de inicialização.

Efeito no tempo de execução

Este MDA não tem efeito sobre o CLR. Ele apenas relata dados sobre o valor de retorno para DllMain.

Saída

Uma mensagem indicando que uma DllMain função, chamada por motivo DLL_PROCESS_ATTACH, retornou FALSE. Observe que esse MDA é ativado somente se DllMain for implementado em código gerenciado.

Configuração

<mdaConfig>
  <assistants>
    <dllMainReturnsFalse />
  </assistants>
</mdaConfig>

Consulte também