AfxLoadLibrary

HINSTANCE AFXAPI AfxLoadLibrary (LPCTSTR lpszModuleName);

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle per il modulo. Se la funzione ha esito negativo, il valore restituito è NULL.

Parametri

lpszModuleName

Punta a una stringa con terminazione null che contiene il nome del modulo (o un.DLL o.File EXE). Il nome specificato è il nome del file del modulo.

Se la stringa specifica un percorso, ma il file nella directory specificata non esiste, la funzione non riesce.

Se non è specificato un percorso e l'estensione viene omesso, l'estensione predefinita.DLL viene accodato. Tuttavia, la stringa del nome del file può includere un finale carattere punto (.) per indicare che il nome del modulo non è estensione. Quando non viene specificato alcun percorso, la funzione cerca il file nella seguente sequenza:

• La directory da cui l'applicazione caricato.
  
  
• La directory corrente.
  
  
• Windows 95: La directory di sistema di Windows. Windows NT: La directory di sistema Windows a 32-bit. Il nome di questa directory è SYSTEM32.
  
  
• Windows NT solo: La directory di sistema di Windows di 16 bit. Non non c'è nessuna funzione Win32 che ottiene il percorso di questa directory, ma si è cercato. Il nome di questa directory è SYSTEM.
  
  
• Directory di Windows.
  
  
• Le directory che sono elencate nella variabile di ambiente PATH.

Osservazioni

Utilizzare AfxLoadLibrary per mappare un modulo DLL. Esso restituisce un handle che può essere utilizzato in GetProcAddress per ottenere l'indirizzo di una funzione DLL. AfxLoadLibrary può anche essere utilizzato per mappare altri moduli eseguibili.

Ogni processo mantiene un conteggio dei riferimenti per ogni modulo libreria caricato. Questo conteggio dei riferimenti viene incrementato ogni volta che AfxLoadLibrary viene chiamato e viene decrementato ogni volta che viene chiamato AfxFreeLibrary . Quando il conteggio dei riferimenti raggiunge lo zero, il modulo è non mappato dallo spazio degli indirizzi del processo chiamante e l'handle non è valido.

Assicurarsi di utilizzare AfxLoadLibrary e AfxFreeLibrary (anziché le funzioni Win32 LoadLibrary e FreeLibrary), se l'applicazione utilizza più thread. Utilizzando AfxLoadLibrary e AfxFreeLibrary assicura che il codice di avvio e di arresto che viene eseguito quando la DLL di estensione è caricati e scaricati non corrotto lo stato globale MFC.

Vedere a&nchenbsp;AfxFreeLibrary