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>