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