功能描述
函式原型:
FARPROC GetProcAddress(
HMODULE hModule, // DLL模組句柄
LPCSTR lpProcName // 函式名
);
參數
hModule
[in] 包含此函式的DLL模組的句柄。LoadLibrary、 AfxLoadLibrary 或者GetModuleHandle函式可以返回此句柄。
lpProcName
[in] 包含函式名的以NULL結尾的字元串,或者指定函式的序數值。如果此參數是一個序數值,它必須在一個字的低位元組,高位元組必須為0。
返回值:
如果函式調用成功,返回值是DLL中的輸出函式地址。
如果函式調用失敗,返回值是NULL。得到進一步的錯誤信息,調用函式GetLastError。
注釋
GetProcAddress函式被用來檢索在DLL中的輸出函式地址。
lpProcName指針指向的函式名,拼寫和大小寫必須和DLL原始碼中的模組定義檔案(.DEF)中輸出段(EXPORTS)中指定的相同。Win32 API函式的輸出名可能不同於你在代碼中調用的這些函式名,這個不同被宏隱含在相關的SDK頭檔案中。如果想得到更多信息,請參考Win32函式原型(Win32 Function Prototypes)。
lpProcName參數能夠識別DLL中的函式,通過指定一個與函式相聯繫的序數值(在.DEF中的EXPORTS段)。GetProcAddress函式驗證那個指定的序數值是否在輸出的序數1和最高序數值之間(在.DEF中)。函式用這個序數值作為索引從函式表中讀函式地址,假如.DEF 檔案不連續地定義函式的序數值,如從1到N(N是輸出的函式序數值),錯誤將會發生,GetProcAddress將會返回一個錯誤的、非空的地址,雖然指定的序數沒有對應的函式。
為了防止函式不存在,函式應該通過名字指定而不是序數值。
要求:
Windows NT/2000: 要求Windows NT 3.1 或以後版本。
Windows 95/98: 要求Windows 95 或以後版本。
頭檔案: 在Winbase.h中聲明,include Windows.h。
庫檔案: Use Kernel32.lib。
參看
動態程式庫縱覽(Dynamic-Link Libraries Overview), 動態程式庫函式(Dynamic-Link Library Functions),FreeLibrary, GetModuleHandle, LoadLibrary
示例代碼:
調用KERNEL32.DLL中的RegisterServiceProcess(僅在Windows98中適用)
HMODULE hModule=GetModuleHandle("kernel32.dll");
if (hModule)
{
typedef DWORD (CALLBACK *LPFNREGISTER)(DWORD,DWORD);
LPFNREGISTER lpfnRegister;
lpfnRegister=(LPFNREGISTER)GetProcAddress(hModule,"RegisterServiceProcess");
if (lpfnRegister)
{
(*lpfnRegister)(NULL,1L);
}
}