AfxOleLockApp

發行項
02/28/2013

架構的應用程式中的作用中物件的數目的通用計數會遞增。

void AFXAPI AfxOleLockApp( );

備註

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

使用者嘗試關閉具有作用中物件的應用程式 — 作用中物件的計數為非零的應用程式，架構會隱藏應用程式無法在使用者的檢視，而非完全關機。AfxOleCanExitApp函式會指示是否可以終止應用程式。

呼叫AfxOleLockApp從任何公開 (expose) OLE 介面而言，如果它要終結時用戶端應用程式仍在使用該物件的非預期的物件。也可呼叫AfxOleUnlockApp在解構函式呼叫的任何物件的AfxOleLockApp在建構函式。根據預設， 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();
}