Partager via


Assistant Débogage managé dllMainReturnsFalse

Remarque

Cet article est spécifique au .NET Framework. Elle ne s’applique pas aux implémentations plus récentes de .NET, notamment .NET 6 et versions ultérieures.

L’Assistant Débogage managé dllMainReturnsFalse est activé si la fonction DllMain managée d’un assembly utilisateur, appelée avec la raison DLL_PROCESS_ATTACH, retourne FALSE.

Symptômes

La fonction DllMain a retourné FALSE, indiquant qu’elle ne s’est pas exécuté correctement. Cela peut entraîner des problèmes indéterminés, car les fonctions DllMain contiennent généralement du code d’initialisation important.

Cause

La fonction DllMain est appelée avec la raison DLL_PROCESS_ATTACH pour l’initialisation de DLL lors du chargement. Si elle retourne FALSE, cela signifie que l’initialisation de la DLL a échoué.

Résolution

Analysez le code de la fonction DllMain de la DLL ayant échoué, et identifiez la cause de l’échec d’initialisation.

Effet sur le runtime

Cet Assistant Débogage managé n'a aucun effet sur le CLR. Il fournit uniquement des données sur la valeur de retour pour DllMain.

Sortie

Un message indiquant qu’une fonction DllMain, appelée pour la raison DLL_PROCESS_ATTACH, a retourné FALSE. Notez que cet Assistant Débogage managé est activé uniquement si DllMain est implémenté dans le code managé.

Configuration

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

Voir aussi