AfxOleLockApp

Article
03/04/2013

Incrémente le nombre total de l'infrastructure du nombre d'objets actifs dans l'application.

void AFXAPI AfxOleLockApp( );

Notes

L'infrastructure conserve le nombre d'objets actif dans une application.Les fonctions d' AfxOleLockApp et d' AfxOleUnlockApp , respectivement, l'incrémentation et décrémentent ce nombre.

Lorsque l'utilisateur tente de fermer une application qui a des objets actifs — une application dont le nombre d'objets actifs est différent de zéro — l'infrastructure masque l'application de la vue standard au lieu de la fermer complètement vers le bas.La fonction d' AfxOleCanExitApp indique si l'application peut s'arrêter.

Appelez AfxOleLockApp de tout objet qui expose de interfaces OLE, s'il serait indésirable pour que cet objet est détruit tout en étant encore utilisé par une application cliente.Appelez également AfxOleUnlockApp dans le destructeur de tout objet qui appelle AfxOleLockApp dans le constructeur.Par défaut, COleDocument (et les classes dérivées) automatiquement verrouillent et déverrouiller 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();
}