AfxLoadLibrary

HINSTANCE AFXAPI AfxLoadLibrary (LPCTSTR LpszModuleName);

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für das Modul. Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL.

Parameter

lpszModuleName

Verweist auf eine Null-terminierte Zeichenfolge, die den Namen des Moduls enthält (entweder ein.DLL oder.EXE-Datei). Der angegebene Name ist der Dateiname des Moduls.

Wenn die Zeichenfolge einen Pfad gibt, aber die Datei ist nicht in das angegebene Verzeichnis vorhanden, schlägt die Funktion fehl.

Wenn kein Pfad angegeben ist und die Dateinamenerweiterung nicht angegeben ist, die Standarderweiterung.DLL wird angefügt. Jedoch kann die Dateiname-Zeichenfolge enthalten, kein nachstehendes Zeichen der Punkt (.) an, dass der Modulname keine Erweiterung hat. Wenn kein Pfad angegeben ist, sucht die Funktion nach der Datei in der folgenden Reihenfolge:

• Das Verzeichnis, aus dem die Anwendung geladen.
  
  
• Das aktuelle Verzeichnis.
  
  
• Windows 95: Das Windows-Systemverzeichnis. Windows NT: Das 32-Bit Windows Systemverzeichnis. Der Name dieses Verzeichnisses ist SYSTEM32.
  
  
• Nur für Windows NT: Das 16-Bit Windows Systemverzeichnis. Es ist keine Win32-Funktion, die den Pfad dieses Verzeichnisses erhält, aber es wird gesucht. Der Name dieses Verzeichnisses ist SYSTEM.
  
  
• Das Windows-Verzeichnis.
  
  
• Die Verzeichnisse, die in der Umgebungsvariablen PATH aufgelistet sind.

Bemerkungen

Verwenden Sie AfxLoadLibrary , um eine DLL-Modul zuzuordnen. Es gibt einen Handle, das in verwendet werden kann GetProcAddress , um die Adresse einer DLL-Funktion abzurufen. AfxLoadLibrary kann auch verwendet werden, um andere ausführbare Module anzeigen.

Jeder Prozess erhält einen Verweiszähler für jedes geladene Bibliothek Modul. Diese Verweiszähler wird jedes Mal inkrementiert, AfxLoadLibrary wird aufgerufen und ist wieder um eins erniedrigt, wenn AfxFreeLibrary aufgerufen wird. Wenn der Verweiszähler 0 (null) erreicht, das Modul ist nicht zugeordnete den Adressraum des aufrufenden Prozesses und der Griff ist nicht mehr gültig.

Achten Sie darauf, AfxLoadLibrary und AfxFreeLibrary (anstelle der Win32-Funktionen LoadLibrary und FreeLibrary) verwenden Wenn Ihre Anwendung mehrere Threads verwendet. Verwendung von AfxLoadLibrary und AfxFreeLibrary stellt sicher, dass der starten und Herunterfahren Code, der ausgeführt wird, wenn die Erweiterungs-DLL geladen und entladen wird den globalen MFC-Zustand nicht beschädigt wird.

Siehe auch&Nbsp;AfxFreeLibrary