AfxOleLockApp

Artigo
06/10/2015

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

void AFXAPI AfxOleLockApp( );

Comentários

A estrutura mantém uma contagem do número de objetos ativa em um aplicativo. As funções de AfxOleLockApp e de AfxOleUnlockApp , respectivamente, incrementam e diminui a contagem.

Quando o usuário tenta desligar um aplicativo que tenha objetos ativas — um aplicativo para que a contagem de objetos ativas for diferente de zero — a estrutura oculta o aplicativo de exibição de usuário completamente em vez de executar o desligamento. A função de AfxOleCanExitApp indica se o aplicativo pode terminar.

Chame AfxOleLockApp de qualquer objeto que expõe as interfaces OLE, se seria indesejável para que o objeto é destruído enquanto ainda ser usado por um aplicativo cliente. Chamar também AfxOleUnlockApp em destruidor de qualquer objeto que chama AfxOleLockApp no construtor. Por padrão, o bloqueio de COleDocument () e classes derivadas automaticamente e desbloqueia o aplicativo.

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