Compartilhar via


AfxOleLockApp

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

void AFXAPI AfxOleLockApp( );

Comentários

A estrutura mantém uma contagem do número de objetos ativos em um aplicativo.O AfxOleLockApp e AfxOleUnlockApp funções, respectivamente, incrementar e decrementar nessa contagem.

Quando o usuário tenta fechar um aplicativo que tenha objetos ativos — um aplicativo para o qual a contagem de objetos ativos é diferente de zero — o framework oculta a exibição do usuário em vez de ele desligar completamente do aplicativo.O AfxOleCanExitApp função indica se o aplicativo pode finalizar.

Chamar AfxOleLockApp de qualquer objeto que expõe interfaces OLE, se seria indesejável para o objeto a ser destruído enquanto ainda sendo usado por um aplicativo cliente.Também chamada AfxOleUnlockApp no 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();
}

Requisitos

Cabeçalho: <afxdisp.h>

Consulte também

Referência

AfxOleUnlockApp

AfxOleCanExitApp

Classe COleDocument

Conceitos

Globais e Macros do MFC