AfxOleLockApp

增加應用程式中框架的作用中物件的全域計數。

void AFXAPI AfxOleLockApp( );

備註

架構會在應用程式保留作用中物件數目的計數。 AfxOleLockApp 和 AfxOleUnlockApp 函式，分別遞增和遞減這個計數。

當使用者嘗試關閉有作用中物件的應用程式—作用中物件計數是非零的應用程式—架構隱藏使用者檢視的應用程式而非完全關閉。 AfxOleCanExitApp 函式會指出應用程式是否可以結束。

如果它仍由用戶端應用程式使用時而不宜終結這個物件時，從公開 OLE 介面的任何物件呼叫 AfxOleLockApp。 請在任何於建構函式呼叫AfxOleLockApp 的物件的解構函式呼叫 AfxOleUnlockApp。 根據預設， COleDocument (和衍生類別) 自動鎖定和解除鎖定應用程式。

範例

// Below is a code sample from an  Application Wizard-generated SDI  
// Application with Automation support. The Application Wizard adds a  
// dispatch interface to the document class. AfxOleLockApp() and 
// AfxOleUnlockApp() respectively increment and decrement the  
// application's object count. When the object count is equal to  
// zero and if the user has not taken control of the application, 
// the server is terminated.

CCMFCAutomationDoc::CCMFCAutomationDoc()
{
    EnableAutomation();
    AfxOleLockApp();
}

CCMFCAutomationDoc::~CCMFCAutomationDoc()
{
    AfxOleUnlockApp();
}

需求

Header: <afxdisp.h>

請參閱

參考

AfxOleUnlockApp

AfxOleCanExitApp

COleDocument 類別

概念

MFC 巨集和全域