3.39 DM_InitMSW

Diese Funktion muss in der Windows-Variante des Dialogs Manager aufgerufen werden, wenn das ausgelieferte "startup.obj" durch ein eigenes Startprogramm ersetzt worden ist. Diese Funktion übernimmt das Parsen der Kommandozeile und speichert alle wichtigen Informationen, die einem Windows-Programm beim Start als Parameter mitgegeben werden.

char far * far*  DML_default DM_EXPORT DM_InitMSW
(
  HANDLE hInstance,
  HANDLE hPrevInstance,
  LPSTR lpCmdLine,
  int *argc
)

Parameter

-> HANDLE hInstance

In diesem Parameter wir ein Zeiger auf die aktuelle Anwendungsinstanz übergeben. Den Wert hierfür erhält jedes Windows-Programm als Parameter.

-> HANDLE hPrevInstance

In diesem Parameter wir eine Zeiger auf die vorangegangene Anwendungsinstanz übergeben. Den Wert hierfür erhält jedes Windows-Programm als Parameter.

<-> LPSTR lpCmdLine

Das ist die eigentliche Kommandozeile, die der Benutzer beim Starten des Programms angegeben hat. Diese Zeile wird von dieser Funktion in einzelne Parameter zerlegt und von dieser Funktion als Rückgabewert zurückgegeben.

-> int *argc

In diesem Parameter wird die Anzahl der Parameter zurückgegeben, die von dieser Funktion aus der Kommandozeile gebildet wurden.

Rückgabewert

Diese Funktion liefert ein Array mit Strings als Ergebnis zurück. Dabei entsprechen die einzelnen Strings der zerlegten Kommandozeile.

Beispiel

Standard-Startup-Datei des Dialog Managers für Windows

int PASCAL WinMain __4(

(HANDLE, hInstance),

(HANDLE, hPrevInstance),

(LPSTR, lpCmdLine),

(int, nCmdShow))

{

  int argc;

  char far * far *argv;

 

  argv = DM_InitMSW(hInstance, hPrevInstance, lpCmdLine,

    &argc);

 

  if (argv)

    return (main (argc, argv));

 

  return (-1);

}