AfxOleLockApp

Artykuł
02/27/2013

Zwiększa licznik globalne ramy liczby aktywnych obiektów w aplikacji.

void AFXAPI AfxOleLockApp( );

Uwagi

Ramy utrzymuje licznik obiektów aktywnych w aplikacji.AfxOleLockApp i AfxOleUnlockApp funkcji, odpowiednio zwiększać i zmniejszyć ten licznik.

Gdy użytkownik próbuje zamknąć aplikację, która ma aktywne obiekty — aplikację, dla której liczba aktywnych obiektów jest niezerowy — ramach ukrywa aplikacji z widoku użytkownika, zamiast całkowicie wyłączaniem go.AfxOleCanExitApp Funkcji wskazuje, czy aplikacja może obsłużyć.

Wywołanie AfxOleLockApp z dowolnego obiektu, który opisuje interfejsy OLE, jeśli byłoby niepożądanych dla tego obiektu do zniszczenia podczas nadal używane przez aplikację klienta.Również wywołać AfxOleUnlockApp w destruktor dowolny obiekt, który wywołuje AfxOleLockApp w konstruktorze.Domyślnie COleDocument (i klasy pochodne) automatycznie blokowanie i odblokowywanie aplikacji.

Przykład

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