3.6 DM_BootStrap

Diese Funktion ist in startup.o/startup.obj enthalten und wird daher normalerweise nicht benutzt.

Mit Hilfe dieser Funktion wird der Dialog Manager intern initialisiert, die Argumente der Kommandozeile gesichert sowie die ersten Aktionen ausgeführt

• -IDMerrfile
• -IDMtracefile

Diese Funktion muss die erste Funktion im Dialog Manager sein, die von der Anwendung aufgerufen wird. Normalerweise erfolgt dieser Aufruf durch das Main-Programm im Dialog Manager, das danach das eigentliche Hauptprogramm der Anwendung AppMain aufruft. Aus diesem Grund darf diese Funktion nur dann aufgerufen werden, wenn das Main des Dialog Managers durch ein eigenes ersetzt wird.

int DML_default DM_EXPORT DM_BootStrap
(
  int *argcp,
  char far * far * far *argvp
)

Parameter

<-> int *argcp

In diesem Parameter wird die Adresse der Anzahl der Parameter übergeben. Diese Parameteranzahl kann dann von DM_BootStrap verändert werden, falls dort schon Argumente verarbeitet werden.

<-> char far * far * far *argvp

Dieser Parameter ist ein Pointer auf die Argumente der Kommandozeile. Aus dieser Kommandozeile werden dann alle von DM_BootStrap verarbeiteten Argumente entfernt.

Rückgabewert

0	Beim Initialisieren ist kein Fehler aufgetreten, der Dialog Manager kann ganz normal gestartet werden.
!=0	Beim Initialisieren ist ein Fehler aufgetreten. Das Programm darf nicht fortgesetzt werden.

Beispiel

Auszug aus der Datei "startup.c", über die Dialog Manager Programme gestartet werden:

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);

      status = AppMain (argc, argv);

    }

  }

  return (status);

}