AfxOleLockApp

Artículo
06/10/2015

Aumenta el número global del marco del número de objetos activos en la aplicación.

void AFXAPI AfxOleLockApp( );

Comentarios

El marco mantiene un recuento del número de objetos activo en una aplicación. Las funciones de AfxOleLockApp y de AfxOleUnlockApp , respectivamente, aumentan y disminuyen este recuento.

Cuando el usuario intenta cerrar una aplicación que tiene objetos activos (una aplicación para la que el recuento de objetos activos es distinto de cero — el marco oculta la aplicación de usuario en lugar completamente de taparla abajo. La función de AfxOleCanExitApp indica si la aplicación puede finalizar.

Llame a AfxOleLockApp de cualquier objeto que exponga interfaces OLE, si sería no para que ese objeto está destruido mientras sigue siendo utilizado por una aplicación cliente. También llame a AfxOleUnlockApp en el destructor de cualquier objeto que llame a AfxOleLockApp en el constructor. De forma predeterminada, el bloqueo de COleDocument (y las clases derivadas) automáticamente y desbloquea la aplicación.

Ejemplo

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