AfxOleLockApp

Articolo
06/10/2015

Incrementa il conteggio complessivo del framework del numero di oggetti attivi nell'applicazione.

void AFXAPI AfxOleLockApp( );

Note

Il framework gestisce un conteggio del numero di oggetti attivo in un'applicazione. Le funzioni di AfxOleUnlockApp e di AfxOleLockApp, rispettivamente, incremento e decrementano il conteggio.

Quando l'utente tenta di chiusura di un'applicazione con oggetti attivi - un'applicazione per il quale il conteggio degli oggetti attivi è diversa da zero alla legenda del framework l'applicazione dal punto di vista dell'utente anziché specificare la chiusura verso il basso. La funzione di AfxOleCanExitApp indica se l'applicazione può terminare.

Chiamare AfxOleLockApp da qualsiasi oggetto che espone le interfacce OLE, se fosse indesiderabile dell'oggetto eliminato mentre è ancora utilizzata da un'applicazione client. Inoltre chiamare AfxOleUnlockApp nel distruttore di qualsiasi oggetto che chiama AfxOleLockApp nel costruttore. Per impostazione predefinita, il blocco classi derivate e ( COleDocument ) e sblocca automaticamente l'applicazione.

Esempio

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