Freigeben über

sbpuinit

  • Artikel

Die funktion sbpuinit initialisiert die DL-BASE.

Syntax

  
USHORT sbpuinit(   
HANDLE *sema4ptr,   
USHORT proctype,   
USHORT servtype,   
UCHAR *uname   
);

Parameter

sema4ptr
Semaphore, erstellt vom Dynamic Access Module (DMOD), wird von DMOD gelöscht, wenn eine Nachricht verfügbar ist. Diese Adresse ist für die interne Verwendung durch Host Integration Server vorgesehen. Die Anwendung sollte anschließend nicht versuchen, auf die Adresse zu verweisen.

Proctype
Prozesstyp: CLIENT–2.

servtype
Dienst-/Clienttyp: CES3270–2.

uname
Zeiger auf einen Zeichenpuffer mit einer Länge von mindestens 21 Zeichen; der LAN-Manager-Benutzername oder ein anderer identifizierende Name, der dem Netzwerkbetriebssystem entspricht, wird an die Anwendung in diesem Puffer zurückgegeben. Die Anwendung muss diesen Parameter nicht verwenden, kann ihn aber für die Anzeige oder Protokollierung verwenden.

Rückgabewert

NO_ERROR
Die Initialisierung war erfolgreich.

Jeder andere Rückgabewert gibt an, dass bei der Initialisierung ein Fehler aufgetreten ist. Dies ist in der Regel ein Betriebssystemrückgabecode. Außerdem werden die folgenden Werte verwendet:

DMLTABF (555)
L-Tabelle ist voll.

DMMNWGI (562)
Fehler beim Abrufen von Netzwerkbetriebssysteminformationen.

DMDSTFL (563)
Die Diensttabelle ist voll.

DMMPIPF (567)
Fehler beim Erstellen einer benannten Pipe.

DMCOMNM (582)
Kein Name für diese Anwendung registriert.

DMCOMDUP (596)
Ein Dienst wird bereits mit demselben Namen ausgeführt.

DMNOTLOG (598)
Der Benutzer ist nicht beim Netzwerkbetriebssystem angemeldet.

DMCFGOPN (616)
Fehler beim Öffnen der Konfigurationsdatei.

DMCFGREAD (618)
Fehler beim Lesen aus der Konfigurationsdatei.

DMNONAP (625)
Das Netzwerkzugriffsprogramm (Network Access Program, NAP) wurde nicht gestartet.

DMMAXAPP (953)
Nur Windows: Die maximale Anzahl gleichzeitiger Anwendungen wurde überschritten.

Hinweise

Der sbpuinit-Einstiegspunkt sollte immer vor allen anderen DL-BASE- oder DMOD-Einstiegspunkten außer SNAGetVersion aufgerufen werden. Bei neuen Emulatoren sollte sepdcrec nach sbpuinit aufgerufen werden. (Aufgrund der Reihenfolge der in älteren Emulatoren verwendeten Aufrufe wird ein Aufruf von sepdcrec vor sbpuinit weiterhin unterstützt, aber diese Reihenfolge wird nicht empfohlen.)