AfxOleLockApp

Article
06/10/2015

Incrémente le compteur global du framework du nombre d'objets actifs dans l'application.

void AFXAPI AfxOleLockApp( );

Notes

Le framework garde le compte du nombre d'objets actifs dans une application. Les fonctions AfxOleLockApp et AfxOleUnlockApp, respectivement, incrémentent et décrémententent ce nombre.

Lorsque l'utilisateur tente de fermer une application qui contient des objets actifs — une application dont le nombre d'objets actifs est différent de zéro — le framework masque l'application de la vue standard utilisateur au lieu de la fermer complètement. La fonction AfxOleCanExitApp indique si l'application peut se terminer.

Appelez AfxOleLockApp depuis n'importe quel objet qui expose des interfaces OLE, s'il est indésirable que cet objet soit détruit lors de sont utilisation par une application cliente. Appelez également AfxOleUnlockApp dans le destructeur de n'importe quel objet qui appelle AfxOleLockApp dans le constructeur. Par défaut, COleDocument (et les classes dérivées) verrouillent et déverrouillent automatiquement l'application.

Exemple

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