GetProcAddress
Aggiornamento: novembre 2007
I processi che si collegano a una DLL in modo esplicito chiamano GetProcAddress per ottenere l'indirizzo di una funzione esportata nella DLL. Per chiamare la funzione della DLL si utilizza il puntatore alla funzione restituito. GetProcAddress accetta come parametri l'handle del modulo DLL (restituito da LoadLibrary, AfxLoadLibrary o GetModuleHandle) e il nome della funzione da chiamare o l'ordinale di esportazione della funzione.
Poiché si chiama la funzione DLL tramite un puntatore e non viene effettuato alcun controllo dei tipi in fase di compilazione, accertarsi che i parametri per la funzione siano corretti affinché non vengano oltrepassati i limiti della memoria assegnata allo stack e non venga provocata una violazione di accesso. Per garantire il supporto indipendente dai tipi, osservare i prototipi delle funzioni esportate e creare oggetti typedef corrispondenti per i puntatori a funzione. Di seguito è riportato un esempio:
typedef UINT (CALLBACK* LPFNDLLFUNC1)(DWORD,UINT);
...
HINSTANCE hDLL; // Handle to DLL
LPFNDLLFUNC1 lpfnDllFunc1; // Function pointer
DWORD dwParam1;
UINT uParam2, uReturnVal;
hDLL = LoadLibrary("MyDLL");
if (hDLL != NULL)
{
lpfnDllFunc1 = (LPFNDLLFUNC1)GetProcAddress(hDLL,
"DLLFunc1");
if (!lpfnDllFunc1)
{
// handle the error
FreeLibrary(hDLL);
return SOME_ERROR_CODE;
}
else
{
// call the function
uReturnVal = lpfnDllFunc1(dwParam1, uParam2);
}
}
Il modo in cui si specifica la funzione desiderata quando si chiama GetProcAddress dipende da come è stata generata la DLL.
È possibile ottenere l'ordinale di esportazione solo se la DLL alla quale ci si collega è stata generata con un file di definizione di modulo (def) e se gli ordinali sono elencati con le funzioni nella sezione EXPORTS del file def della DLL. La chiamata a GetProcAddress con un ordinale di esportazione è leggermente più veloce rispetto all'uso del nome della funzione se la DLL ha molte funzioni esportate, poiché gli ordinali di esportazione funzionano come indici nella tabella di esportazione della DLL. Con un ordinale di esportazione, GetProcAddress può individuare la funzione direttamente anziché confrontare il nome specificato con i nomi delle funzioni nella tabella di esportazione della DLL. Si consiglia tuttavia di chiamare GetProcAddress con un ordinale di esportazione solo se si è in grado di controllare l'assegnazione degli ordinali alle funzioni esportate nel file def.