Fonction de rappel DllMain Expert

L’expert implémente la fonction DllMain . Le système d’exploitation appelle DllMain pour obtenir un handle à un instance de l’expert.

Syntaxe

BOOL WINAPI DllMain(
  _Out_ HINSTANCE hInstance,
  _In_  ULONG     ulReason,
        LPVOID    Reserved
);

Paramètres

hInstance [out]

Gérer à un instance de l’expert.

Si l’expert utilise l’interface utilisateur du moniteur réseau, la valeur hInstance doit être stockée dans une variable globale. Cette approche est nécessaire uniquement lorsque la valeur du paramètre ulReason est définie sur DLL_PROCESS_ATTACH.

ulReason [in]

Indicateur de la raison pour laquelle la fonction a été appelée. La valeur DLL_PROCESS_ATTACH (qui s’applique lors du premier chargement de la DLL) indique que l’expert doit enregistrer la valeur hInstance dans une variable globale.

Avec toute autre valeur, tous les appels à la fonction DllMain peuvent être ignorés. Pour obtenir la liste de tous les indicateurs possibles définis par le système d’exploitation, consultez DLLMain.

Reserved

Le paramètre n’est pas utilisé.

Valeur retournée

Si la fonction réussit, la valeur de retour est TRUE.

Si la fonction échoue, la valeur de retour est FALSE.

Notes

Le système d’exploitation appelle la fonction d’expert DllMain lorsqu’un processus charge ou décharge la DLL d’expert. La fonction d’expert DllMain doit être exportée uniquement si l’expert dispose d’une interface utilisateur pour afficher la configuration ou les résultats, puis uniquement pour retourner la valeur hInstance appropriée.

La fonction d’expert DllMain est basée sur la fonction DllMain de la bibliothèque de liens dynamiques.

Spécifications