AfxLoadLibrary

Wystąpienie HINSTANCE AFXAPI AfxLoadLibrary (LPCTSTR lpszModuleName);

Wartość zwracany

Jeśli funkcja powiedzie się, wartość zwracany jest dojściem do modułu. Jeśli funkcja zawiedzie, wartość zwracana jest wartość NULL.

Parametry

lpszModuleName

Wskazuje ciąg zakończony znakiem null, który zawiera nazwę modułu (albo.Biblioteka DLL lub.Plik EXE). Określona nazwa jest nazwą pliku modułu.

Jeśli ciąg określa ścieżkę, ale plik nie istnieje w katalogu określonym, funkcja zawiedzie.

Jeśli ścieżka nie zostanie określona, a rozszerzenie nazwy pliku zostanie pominięty, domyślnie rozszerzenie.Biblioteka DLL jest dołączany. Jednakże ciąg Nazwa pliku może zawierać końcowy znak punkt (.) do wskazują, że nazwa modułu bez rozszerzenia. Jeśli ścieżka nie zostanie określona, funkcja wyszukuje plik w następującej sekwencji:

• Katalogu, z którego ładowany aplikacji.
  
  
• Bieżący katalog.
  
  
• Systemu Windows 95: Katalogu systemu Windows. Systemu Windows NT: 32-Bitowe katalogu systemu Windows. Nazwa katalogu jest katalog SYSTEM32.
  
  
• Tylko systemu Windows NT: 16-Bitowe katalogu systemu Windows. Nie ma żadnych funkcji Win32, który uzyskuje ścieżkę katalogu, ale jest przeszukiwana. Nazwa katalogu jest SYSTEM.
  
  
• Katalog Windows.
  
  
• Katalogi wymienione w zmiennej środowiskowej PATH.

Uwagi

Użyj AfxLoadLibrary aby zamapować modułu DLL. Zwraca uchwyt, który może być używany w funkcji GetProcAddress Aby uzyskać adres funkcję DLL. AfxLoadLibrary może również służyć do mapę inne moduły wykonywalny.

Każdy proces przechowuje licznika odwołań do każdego modułu załadowanej biblioteki. Ten licznik odniesienia jest zwiększany o jeden przy każdym AfxLoadLibrary nazywa się i jest zmniejszana każdorazowo, który nazywa się AfxFreeLibrary . Gdy licznika odwołań osiągnie zero, moduł jest nie mapowany z przestrzeni adresowej procesu wywołującego i dojście nie jest już prawidłowy.

Należy koniecznie używać AfxLoadLibrary i AfxFreeLibrary (zamiast funkcji Win32 LoadLibrary i FreeLibrary), jeśli dana aplikacja korzysta z wielu wątków. Korzystanie z AfxLoadLibrary i AfxFreeLibrary już, że kod uruchamiania i zamykania, który jest wykonywany, gdy biblioteka DLL rozszerzenia jest załadowane lub wyładowane nie spowodować uszkodzenie globalnego Państwo MFC.

Zobacz też AfxFreeLibrary