AfxOleLockApp

Artikel
06/10/2015

Inkrementiert die globale Anzahl des Framework der Anzahl von aktiven Objekten in der Anwendung.

void AFXAPI AfxOleLockApp( );

Hinweise

Das Framework enthält die Anzahl von Objekten aktiv in einer Anwendung. Die Funktionen AfxOleLockApp und AfxOleUnlockApp bzw. inkrementieren und dekrementieren diese Anzahl.

Wenn der Benutzer versucht, eine Anwendung zu schließen, die aktive Objekte verfügt - eine Anwendung, für die die Anzahl von aktiven Objekten nicht 0 ist - das Framework blendet die Anwendung von der Benutzersicht aus, anstatt, diese völlig unten zu schließen. Die AfxOleCanExitApp-Funktion gibt an, ob die Anwendung beendet werden kann.

Rufen Sie AfxOleLockApp aus allen Objekt auf, das OLE-Schnittstellen verfügbar macht, wenn unerwünscht sein würde, sodass dieses Objekt zerstört werden kann bei durch eine Clientanwendung weiterhin verwendet werden. Rufen Sie AfxOleUnlockApp im Destruktor eines Objekts auf, das AfxOleLockApp im Konstruktor aufgerufen wird. Standardmäßig sperren ( COleDocument und abgeleitete Klassen) automatisch und setzen die Anwendung gemeinsam.

Beispiel

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