Freigeben über

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 im Format "PROPERTY=VALUE", durch Leerzeichen getrennt dargestellt. Verbindungseigenschaftennamen und -werte werden 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 "Nicht signiertes Zeichen", 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, bis die BIND- und SDT-Befehle eingetroffen sind. Wenn das Timeout abläuft, bevor das SDT eingeht, wird die LU des SNA-Servers freigegeben und ein Fehler wird angezeigt.

Die Eingabe von 0xfffffff in timeout weist auf unendliche Wartezeit hin.
sessionHandle Wenn diese Methode erfolgreich zurückkehrt, enthält sie einen Zeiger auf die IUnknown-Schnittstelle für das comLU0-Sitzungsobjekt, das die zugrunde liegende LU0-Sitzung repräsentiert. Solange ein Verweis auf diese Schnittstelle beibehalten wird, bleibt das Sitzungsobjekt erhalten.

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 kann Eingaben empfangen.

Dieser Rückgabecode gilt nur, wenn initType auf INIT_SSCP gesetzt 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_LOGON gesetzt ist.
CLU0_E_BADPARM connectionStr enthält eine ungültige Eigenschaftseinstellung.
CLU0_E_NOFREELU Die LU, die in luname angegeben ist, ist ein Pool für SNA-Server-LUs. Der Pool verfügt derzeit über keine freien LUs.
CLU0_E_LUINUSE Die im luname angegebene LU ist eine SNA-Server-LU. Diese LU wird derzeit von einer anderen Anwendung verwendet.
CLU0_E_LUNOTFOUND Der LU- oder Poolname existiert nicht.
CLU0_E_TIMEDOUT Die Sitzung wurde nicht innerhalb des angegebenen Timeouts gestartet.
CLU0_E_SESSION_FAILED Die Sitzung konnte nicht aktiviert werden und ist nicht mit einer TSS LU0-Sitzung verbunden.

Die Anwendung sollte versuchen, eine neue Sitzung mit denselben oder unterschiedlichen Verbindungseigenschaften zu erstellen, oder eine andere 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 Fehlgeschlagen aufgrund eines internen Fehlers.

Bemerkungen

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 von der PLU.
INIT_SSCP 1 Warten Sie, bis ein BIND und ein SDT eingeht, während der Zugriff auf die SSCP-Sitzung erlaubt bleibt, um der Anwendung das Senden von SSCP-Daten und -Befehlen zu ermöglichen.
INIT_INITSELF 2 Warten Sie, bis ein BIND und ein SDT eingehen, nachdem Sie den in data angegebenen INITSELF-Befehl gesendet haben.
INIT_LOGON 3 Warten Sie, bis ein BIND und ein SDT eingehen, nachdem Sie die UNFORMATTED SSCP-Anmeldenachricht gesendet haben, die in data spezifiziert ist.

Siehe auch

IcomLU0-Methoden
Session Integrator für LU0

  • Last updated on