AfxOleCanExitApp

Artikel
02/26/2013

Gibt an, ob die Anwendung beendet werden kann.

BOOL AFXAPI AfxOleCanExitApp( );

Rückgabewert

Ungleich 0 (null), wenn die Anwendung beenden kann; andernfalls 0.

Hinweise

Eine Anwendung sollte nicht beendet werden, wenn sie ausstehende Verweise auf seine Objekte vorhanden sind.Die globalen Funktionen und AfxOleLockApp Inkrementieren und Dekrementieren AfxOleUnlockApp jeweils ein Indikator der Verweise auf Objekte der Anwendung.Die Anwendung sollte nicht beendet werden, wenn dieser Zähler ungleich 0 (null) ist.Wenn der Zähler ungleich 0 (null) ist, wird das Hauptfenster der Anwendung ausgeblendet (nicht zerstört) von Schließen im Systemmenü beim Beenden oder im Menü Datei auswählt.Das Framework ruft diese Funktion auf CFrameWnd::OnClose an.

Beispiel

// Helper exit function for automation server
BOOL CMainFrame::CanExit()
{
   if (AfxOleCanExitApp())
   {
      // No outstanding object counts - go ahead and exit
      return TRUE;
   } 
   else
   {
      // There are outstanding OLE object counts...
      // hide app to give user impression that application has exited.
      ShowWindow(SW_HIDE);
      // take user out of control of the app
      AfxOleSetUserCtrl(FALSE);
      return FALSE;
   }
}