Share via


MDA dllMainReturnsFalse

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

Sintomas

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

Causa

A função DllMain é chamada com o motivo DLL_PROCESS_ATTACH para a inicialização da DLL após o carregamento. Se ela retorna FALSE, isso significa que a inicialização da DLL falhou.

Resolução

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

Efeito sobre o runtime

Esse MDA não tem efeito sobre o CLR. Ele apenas relata dados sobre o valor retornado de DllMain.

Saída

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

Configuração

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

Confira também