AfxLoadLibrary

HINSTANCE AFXAPI AfxLoadLibrary (LPCTSTR lpszModuleName);

Valeur de retour

Si la fonction réussit, la valeur de retour est un handle vers le module. Si la fonction échoue, la valeur de retour est NULL.

Paramètres

lpszModuleName

Pointe vers une chaîne terminée par null qui contient le nom du module (soit un.DLL ou.Fichier EXE). Le nom spécifié est le nom de fichier du module.

Si la chaîne spécifie un chemin d'accès, mais le fichier n'existe pas dans le répertoire spécifié, la fonction échoue.

Si un chemin d'accès n'est pas spécifié et que l'extension de nom de fichier est omise, l'extension par défaut.DLL est joint en annexe. Toutefois, la chaîne de nom de fichier peut inclure un caractère fin de point (.) pour indiquer que le nom de module n'a pas d'extension. Lorsque aucun chemin n'est spécifié, la fonction de recherche pour le fichier dans l'ordre suivant:

• Le répertoire à partir duquel l'application est chargée.
  
  
• Le répertoire en cours.
  
  
• Windows 95 : Le répertoire système de Windows. Windows NT : Le répertoire système de Windows 32 bits. Le nom de ce répertoire est SYSTEM32.
  
  
• Windows NT uniquement : Le répertoire système de Windows 16 bits. Il n'existe aucune fonction Win32 qui obtient le chemin d'accès de ce répertoire, mais il est recherché. Le nom de ce répertoire est le système.
  
  
• Le répertoire de Windows.
  
  
• Les répertoires qui sont énumérés dans la variable d'environnement PATH.

Remarques

Utiliser AfxLoadLibrary pour mapper un module DLL. Elle renvoie un handle qui peut être utilisé en GetProcAddress pour obtenir l'adresse d'une fonction DLL. AfxLoadLibrary peut également servir à la carte des autres modules exécutables.

Chaque processus possède un décompte de références pour chaque module chargé bibliothèque. Ce décompte de références est incrémenté chaque fois AfxLoadLibrary est appelée et est décrémenté à chaque fois Qu'afxfreelibrary est appelée. Lorsque le décompte atteint zéro, le module est non mappé à l'espace d'adressage du processus appelant et la poignée n'est plus valide.

Veillez à utiliser AfxLoadLibrary et AfxFreeLibrary (au lieu des fonctions Win32 LoadLibrary et FreeLibrary), si votre application utilise plusieurs threads. À l'aide de AfxLoadLibrary et AfxFreeLibrary assure que le code de démarrage et d'arrêt qui s'exécute lorsque la DLL d'extension est chargé et déchargé ne corrompt pas l'état global de la MFC.

Voir aussi  ;AfxFreeLibrary