AfxOleLockApp

Artigo
08/25/2010

Incrementa a contagem global da estrutura do número de objetos ativo no aplicativo.

void AFXAPI AfxOleLockApp( );

Comentários

A estrutura mantém uma contagem do número de objetos ativo em um aplicativo.The AfxOleLockApp e AfxOleUnlockApp funções, respectivamente, incrementam e decrementam nessa contagem.

Quando o usuário tenta fechar um aplicativo que tenha objetos ativo — um aplicativo para o qual a contagem de objetos ativo é diferente de zero — o estrutura oculta a exibição do usuário em vez de completamente desligá-lo do aplicativo.The AfxOleCanExitApp função indica se o aplicativo pode terminar.

De telefonarAfxOleLockApp de qualquer objeto que expõe interfaces OLE, caso pode ser indesejável para o objeto a ser destruído enquanto ainda está sendo usado por um aplicativo cliente. Também telefonar AfxOleUnlockApp o destruidor de qualquer objeto que chama AfxOleLockApp no construtor. Por padrão, COleDocument (e classes derivadas) bloquear e desbloquear o aplicativo automaticamente.

Exemplo

// 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();
}