AfxInitExtensionModule和AfxTermExtensionModule
生活随笔
收集整理的這篇文章主要介紹了
AfxInitExtensionModule和AfxTermExtensionModule
小編覺得挺不錯的,現在分享給大家,幫大家做個參考.
一個很好的API查詢網站 www.apihome.cn
AfxInitExtensionModule
BOOL AFXAPI AfxInitExtensionModule( AFX_EXTENSION_MODULE& state, HMODULE hModule );
返回值:
如果成功地初始化了擴展DLL,則返回TRUE;否則返回FALSE。
參數:
| state | 對初始化后包含了擴展DLL模塊狀態的AFX_EXTENSION_MODULE結構的引用。這個狀態中包含了擴展DLL在進入DllMain之前作為一般靜態對象構造過程的一部分而初始化的運行類對象的拷貝。 |
| hModule | 擴展DLL模塊的句柄。 |
說明:
在擴展DLL的DllMain中調用此函數以初始化DLL。例如:
static AFX_EXTENSION_MODULE extensionDLL;
extern "C" int APIENTRY
DllMain(HINSTANCE hInstance, DWORD dwReason, LPVOID)
{
??if(dwReason == DLL_PROCESS_ATTACH)
??{
????// 擴展DLL 一次性初始化
????if(!AfxInitExtensionModule(extensionDLL, hInstance)) return 0;
????...
??}
}
AfxInitExtensionModule生成DLL的HMODULE的一個拷貝,并捕捉DLL的運行類(CRuntimeClass結構)和它的對象工廠(COleObjectFactory對象)以供創建CDynLinkLibrary時使用。
MFC的擴展DLL必須在它們的DllMain函數中做兩件事情:
| · | 調用AfxInitExtensionModule 并檢驗返回值。 |
| · | 如果DLL要引出CRuntimeClass對象或者具有它自己的資源,則創建一個CDynLinkLibrary對象。 |
請參閱:AfxTermExtensionModule
AfxTermExtensionModule
void AFXAPI AfxTermExtensionModule(
?????AFX_EXTENSION_MODULE& state,
?????BOOL bAll = FALSE
????);
參數:
| state | 對一個AFX_EXTENSION_MODULE結構的引用,其中包含了擴展DLL模塊的狀態。 |
| bAll | 如果為TRUE,清除所有的擴展DLL模塊。否則,只清除當前的DLL模塊。 |
說明:
調用這個函數,使每個進程與DLL分離(這在進程退出時發生,或者是由于調用了AfxFreeLibrary,DLL被卸載)的時候MFC可以清除擴展DLL。
AfxTermExtensionModule將刪除所有與模塊相連的局部內容并從消息映射中除去所有的入口。例如:
static AFX_EXTENSION_MODULE extensionDLL;
extern "C" int APIENTRY
DllMain(HINSTANCE hInstance, DWORD dwReason, LPVOID)
{
??if(dwReason == DLL_PROCESS_ATTACH)
??{
????// 擴展 DLL 的一次性初始化
????if(!AfxInitExtensionModule( extensionDLL, hInstance)) return 0;
????// 任務:執行其它的初始化工作
??}
??else if(dwReason == DLL_PROCESS_DETACH)
??{
????// 擴展DLL的每個進程結束
????AfxTermExtensionModule(extensionDLL);
????// 任務:執行其它的清除工作。
??}
??return 1; // 完成
}
如果你的應用程序動態地載入、釋放擴展DLL,確保調用了AfxTermExtensionModule。因為大多數擴展DLL不是動態載入(通常,它們與其引入庫相連接)的,通常沒有必要調用AfxTermExtensionModule。
MFC的擴展DLL需要在它們的DllMain中調用AfxInitExtensionModule。如果DLL將輸出CRuntimeClass對象或者具有它自己的資源,你也需要在DllMain中創建CDynLinkLibrary對象。
總結
以上是生活随笔為你收集整理的AfxInitExtensionModule和AfxTermExtensionModule的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: VC++ 创建Windows服务
- 下一篇: 空结构体和空类