Syntax:

HLLJOB LlJobOpen(INT nLanguage);

Aufgabe:

Öffnet den DLL-Job. Fast alle DLL-Befehle benötigen den Rückgabewert dieser Funktion als Parameter.

Parameter:

nLanguage: Gewählte Sprache für Benutzerinteraktionen

Weitere Konstanten in den Deklarationsdateien.

Wenn dieser Parameter mit dem Wert LL_JOBOPENFLAG_NOLLXPRELOAD ver"odert" wird, werden die List & Label-Extensions nicht (vor-)geladen.

Rückgabewert:

Ein Handle, das bei den meisten Funktionen als Parameter benötigt wird, um auf die applikationsspezifischen Daten zugreifen zu können.

Ein gültiger Wert ist größer als 0. Ist der Wert kleiner 0, handelt es sich um einen Fehlercode. Für weitere Details siehe die Kapitel Allgemeines zum Rückgabewert und Fehlercodes.

Hinweise:

Aus Übersichtsgründen empfehlen wir, globale Einstellungen, die für alle List & Label-Aufrufe gelten sollen, ein einziges Mal nach LlJobOpen() zu tätigen (z. B. Dialogdesign oder Callback-Modi).

Die C?LL29-DLL benötigt die sprachabhängigen Teile in einer separaten DLL, z. B. C?LL2900.LNG oder C?LL2901.LNG, die je nach Sprach-Einstellung benutzt werden.

Wenn List & Label nicht mehr benötigt wird, sollte der Job über die Funktion LlJobClose() wieder freigegeben werden, um der DLL eine Chance zu geben, die internen Variablen zu diesem Job freigeben zu können.

Beispiel:

HLLJOB hJob;

hJob = LlJobOpen(CMBTLANG_­GERMAN);
LlDefineVariableStart(hJob);
LlDefineVariable(hJob, "Name", "Normalverbraucher");
LlDefineVariable(hJob, "Vorname", "Otto");
<... etc ...>
LlJobClose(hJob);

Siehe auch:

LlJobOpenLCID, LlJobClose, LlSetOption, LlSetOptionString