3.69 DM_ShutDown

Mit Hilfe dieser Funktion wird der Dialog Manager vollständig beendet. Nach einem Aufruf dieser Funktion ist ein Weiterarbeiten mit dem Dialog Manager unmöglich, da alle globalen Initialisierungsschritte rückgängig gemacht werden.

Diese Funktion wird normalerweise von der Funktion aufgerufen, die das AppMain in der Anwendung aufruft.

Daher darf diese Funktion nur dann aufgerufen werden, wenn das eigentliche Main-Programm im Dialog Manager durch ein eigenes ersetzt wird.

void DML_default DM_EXPORT DM_ShutDown
(
  void
)

Parameter

Keine.

Rückgabewert

Keiner.

Beispiel

Startprogramm des Dialog Managers, das im Normalfall über die Datei startup.o bzw. startup.obj dazugelinkt wird.

int cdecl main __2(

(int, argc),

(char far * far *, argv))

{

  register int status;

  static char running = 0;

 

  if ((status = running++) == 0)

  {

    if ((status = DM_BootStrap(&argc, &argv)) == 0)

    {

      DM_InitOptions(&argc, argv, 0);

      DM_TraceMessage ("[AC] Transfer to AppMain(...)",

        DMF_Printf | DMF_InhibitTag);

      status = AppMain (argc, argv);

      DM_TraceMessage ("[AR] AppMain() = %d", DMF_Printf |

        DMF_InhibitTag, status);

 

      DM_ShutDown();

    }

    else DM_TraceMessage ("Bootstrap failed", DMF_LogFile);

  }

  else

    DM_FatalAppError ("Unexpected restart", -1, 0);

  return (status);

}