IcomLUO.CreateSession-Methode

Erstellt eine neue LU0-Sitzung.

Syntax

  
void CreateSession(  
   string connectionSTR,  
   short initType,  
   ref System.Array data,  
   int timeout,  
   out object sessionHandle  
)  

Parameter

Parameter	BESCHREIBUNG
connectionSTR	NULL-beendete Zeichenfolge, die die Verbindungseigenschaften der neuen Sitzung angibt. Die Zeichenfolge wird in einem "PROPERTY=VALUE"-Format mit Leerzeichen dargestellt. Bei Verbindungseigenschaftennamen und -werten wird die Groß-/Kleinschreibung nicht beachtet. Weitere Informationen zu Verbindungseigenschaften finden Sie unter IcomLUO-Sitzungseigenschaften.
initType	Enthält den Sitzungsinitialisierungstyp. Weitere Informationen finden Sie im Abschnitt „Kommentare“.
data	Zeiger eines Arrays vom Typ "Zeichen ohne Vorzeichen", das die INITSELF- oder SSCP-Anmeldemeldung enthält. Wird nur verwendet, wenn initType INIT_INITSELF oder INIT_LOGON enthält.
timeout	Der Zeitraum in Millisekunden, um auf das Eintreffen der Befehle BIND und SDT zu warten. Wenn das Timeout abläuft, bevor das SDT eintrifft, wird die SNA-Server-LU freigegeben und ein Fehler zurückgegeben. Die Eingabe 0xfffffff in timeout bedeutet eine unendliche Wartezeit.
sessionHandle	Wenn diese Methode erfolgreich zurückgegeben wird, enthält einen Zeiger auf die IUnknown-Schnittstelle auf das comLU0-Sitzungsobjekt, das die zugrunde liegende LU0-Sitzung darstellt. Während ein Verweis auf diese Schnittstelle beibehalten wird, bleibt das Sitzungsobjekt intakt. Diese Schnittstelle kann an die IcomLU0.Connect-Methode übergeben werden, um eine Verbindung mit dem comLU0-Objekt mit der Sitzung herzustellen. Wenn keine LU-Eigenschaft angegeben ist, wählt comLU0 die beste verfügbare LU aus, die dem Benutzerkonto zugewiesen ist, unter dem sie ausgeführt wird.

Rückgabewert

In der folgenden Tabelle werden die Rückgabecodes für CreateSession beschrieben.

Wert	BESCHREIBUNG
S_OK	Die LU0-Sitzung wurde erfolgreich erstellt. Die LU-Sitzung ist aktiv und kann Eingaben empfangen.
CLU0_S_SSCP_ACTIVE	Die LU0-Sitzung wurde erfolgreich erstellt. Die SSCP-Sitzung ist aktiv und bereit, Eingaben zu empfangen. Dieser Rückgabecode ist nur gültig, wenn initType auf INIT_SSCPfestgelegt ist.
CLU0_E_NEG_RESPONSE	Der Host oder SNA-Server hat eine negative Antwort an die INITSELF gesendet. Optional hat der Host oder SNA-Server möglicherweise einen unformatierten Anmeldebefehl gesendet. Dies gilt nur, wenn initType auf INIT_INITSELF oder INIT_LOGONfestgelegt ist.
CLU0_E_BADPARM	connectionStr enthält eine ungültige Eigenschaftseinstellung.
CLU0_E_NOFREELU	Die in luname angegebene LU ist ein SNA-Server-LU-Pool. Der Pool verfügt derzeit über keine freien LUs.
CLU0_E_LUINUSE	Die in luname angegebene LU ist eine SNA-Server-LU. Diese LU wird derzeit von einer anderen Anwendung verwendet.
CLU0_E_LUNOTFOUND	Die LU oder der Poolname ist nicht vorhanden.
CLU0_E_TIMEDOUT	Die Sitzung wurde nicht innerhalb des angegebenen Timeouts gestartet.
CLU0_E_SESSION_FAILED	Die Sitzung konnte nicht aktiviert werden und ist mit keiner TSS LU0-Sitzung verbunden. Die Anwendung sollte versuchen, eine neue Sitzung mit den gleichen oder anderen Verbindungseigenschaften zu erstellen, oder andernfalls eine Verbindung mit einem anderen TSS-Sitzungshandle herstellen.
CLU0_E_ACCESSDENIED	Das Benutzerkonto für den Client verfügt nicht über die Berechtigung, die angeforderte LU oder den angeforderten Pool zu verwenden.
CLU0_E_ALREADY_CONNECTED	Der comLU0-Client ist bereits mit einer anderen Sitzung verbunden.
CLU0_E_SYSERROR	Fehler aufgrund eines internen Fehlers.

Hinweise

Die folgende Tabelle enthält die möglichen Werte für initType.

Name	Wert	BESCHREIBUNG
INIT_BIND	0	Warten Sie auf eine nicht angeforderte BIND- und SDT-Datei von der PLU.
INIT_SSCP	1	Warten Sie, bis eine BIND- und SDT-Instanz eintreffen, erlauben Sie jedoch den Zugriff auf die SSCP-Sitzung, damit die Anwendung SSCP-Daten und -Befehle senden kann.
INIT_INITSELF	2	Warten Sie, bis nach dem Senden des in dataangegebenen INITSELF-Befehls ein BIND und SDT eintreffen.
INIT_LOGON	3	Warten Sie nach dem Senden der UNFORMATTED SSCP-Anmeldenachricht, die in dataangegeben ist, bis bind und SDT eintreffen.

Weitere Informationen

IcomLU0-Methoden
Session Integrator für LU0