Partager via

IcomLUO.CreateSession, méthode

Crée une session LU0.

Syntaxe

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

Paramètres

Paramètre Description
connectionSTR Chaîne terminée par NULL qui indique les propriétés de connexion de la nouvelle session. La chaîne est présentée dans un format « PROPERTY=VALUE », délimité par des espaces. Les noms et valeurs des propriétés de connexion ne respectent pas la casse. Pour plus d’informations sur les propriétés de connexion, consultez Propriétés de session IcomLUO.
initType Contient le type d’initialisation de session. Pour plus d'informations, voir la section Commentaires.
data Pointeur : tableau de type char non signé qui contient le message d’ouverture de session INITSELF ou SSCP. Utilisé uniquement si initType contient INIT_INITSELF ou INIT_LOGON.
timeout Période d’attente en millisecondes avant l’arrivée des commandes BIND et SDT. Si le délai d’expiration expire avant l’arrivée du SDT, l’unité lu du serveur SNA est libérée et une erreur est retournée.

L’entrée 0xfffffff dans timeout indique un temps d’attente infini.
sessionHandle Lorsque cette méthode retourne correctement, contient un pointeur vers l’interface IUnknown vers l’objet de session comLU0 représentant la session LU0 sous-jacente. Comme une référence à cette interface est conservée, l’objet de session reste intact.

Cette interface peut être passée à la méthode IcomLU0.Connect pour se connecter à l’objet comLU0 avec la session.

Si aucune propriété LU n’est spécifiée, comLU0 sélectionne la meilleure lu disponible affectée au compte d’utilisateur sous lequel elle s’exécute.

Valeur renvoyée

Le tableau suivant décrit les codes de retour pour CreateSession.

Valeur Description
S_OK La session LU0 a été créée avec succès. La session LU est active et prête à recevoir des entrées.
CLU0_S_SSCP_ACTIVE La session LU0 a été créée avec succès. La session SSCP est active et prête à recevoir des entrées.

Ce code de retour est valide uniquement lorsque initType est défini sur INIT_SSCP.
CLU0_E_NEG_RESPONSE L’hôte ou le serveur SNA a envoyé une réponse négative à INITSELF.

Si vous le souhaitez, l’hôte ou le serveur SNA peut avoir envoyé une commande d’ouverture de session non mise en forme. Cette valeur est vraie uniquement si initType a la valeur INIT_INITSELF ou INIT_LOGON.
CLU0_E_BADPARM connectionStr contenait un paramètre de propriété non valide.
CLU0_E_NOFREELU L’unité lu spécifiée dans luname est un pool d’unités lu de serveur SNA. Le pool n’a actuellement aucune LU gratuite.
CLU0_E_LUINUSE L’unité lu spécifiée dans luname est une lu de serveur SNA. Cette lu est actuellement utilisée par une autre application.
CLU0_E_LUNOTFOUND Le nom de l’unité lu ou du pool n’existe pas.
CLU0_E_TIMEDOUT La session n’a pas été démarrée dans le délai spécifié.
CLU0_E_SESSION_FAILED La session n’a pas pu s’activer et n’est connectée à aucune session LU0 TSS.

L’application doit tenter de créer une session à l’aide des propriétés de connexion identiques ou différentes, ou bien se connecter à un autre handle de session TSS.
CLU0_E_ACCESSDENIED Le compte d’utilisateur du client n’a pas l’autorisation d’utiliser l’unité lu ou le pool demandé.
CLU0_E_ALREADY_CONNECTED Le client comLU0 est déjà connecté à une autre session.
CLU0_E_SYSERROR Échec en raison d’une erreur interne.

Remarques

Le tableau suivant contient les valeurs possibles pour initType.

Nom Valeur Description
INIT_BIND 0 Attendez un BIND et un SDT non sollicités à partir du PLU.
INIT_SSCP 1 Attendez qu’un BIND et un SDT arrivent, mais autorisez l’accès à la session SSCP pour que l’application envoie des données et des commandes SSCP.
INIT_INITSELF 2 Attendez qu’un BIND et un SDT arrivent après l’envoi de la commande INITSELF spécifiée dans data.
INIT_LOGON 3 Attendez qu’un BIND et un SDT arrivent après l’envoi du message d’ouverture de session SSCP non formaté spécifié dans data.

Voir aussi

Méthodes IcomLU0
Intégrateur de sessions pour LU0

  • Last updated on