Método IcomLUO.CreateSession

Crea una nueva sesión LU0.

Sintaxis

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

Parámetros

Parámetro Descripción
connectionSTR Cadena terminada en NULL que indica las propiedades de conexión de la nueva sesión. La cadena se presenta en un formato "PROPERTY=VALUE", con espacio delineado. Los valores y los nombres de propiedad de conexión no tienen en cuenta las mayúsculas y minúsculas. Para obtener más información sobre las propiedades de conexión, vea Propiedades de sesión de IcomLUO.
initType Contiene el tipo de inicialización de sesión. Para obtener más información, vea la sección Comentarios.
data Puntero a una matriz de tipo unsigned char que contiene el mensaje de inicio de sesión INITSELF o SSCP. Se usa solo si initType contiene INIT_INITSELF o INIT_LOGON.
timeout Período de tiempo en milisegundos que se espera a que lleguen los comandos BIND y SDT. Si el tiempo de espera expira antes de que llegue el SDT, se liberará la LU del servidor SNA y se devolverá un error.

Escribir en 0xfffffff indica timeout un tiempo de espera infinito.
sessionHandle Cuando este método vuelve correctamente, contiene un puntero a la interfaz IUnknown al objeto de sesión comLU0 que representa la sesión LU0 subyacente. Al igual que se mantiene una referencia a esta interfaz, el objeto de sesión permanecerá intacto.

Esta interfaz se puede pasar a IcomLU0. Conectar método para conectarse al objeto comLU0 con la sesión.

Si no se especifica ninguna propiedad lu, comLU0 seleccionará la mejor LU disponible asignada a la cuenta de usuario en la que se ejecuta.

Valor devuelto

En la tabla siguiente se describen los códigos de retorno de CreateSession.

Valor Descripción
S_OK La sesión LU0 se creó correctamente. La sesión de LU está activa y lista para recibir la entrada.
CLU0_S_SSCP_ACTIVE La sesión LU0 se creó correctamente. La sesión de SSCP está activa y lista para recibir la entrada.

Este código de retorno solo es válido cuando initType se establece en INIT_SSCP.
CLU0_E_NEG_RESPONSE El servidor host o SNA envió una respuesta negativa a INITSELF.

Opcionalmente, el host o el servidor SNA pueden haber enviado un comando de inicio de sesión sin formato. Esto solo es cierto si initType se establece en INIT_INITSELF o INIT_LOGON.
CLU0_E_BADPARM connectionStr contenía una configuración de propiedad no válida.
CLU0_E_NOFREELU La LU especificada en es un luname grupo de LU de servidor SNA. El grupo no tiene actualmente ninguna LUs gratuita.
CLU0_E_LUINUSE La LU especificada en es una luname LU de servidor SNA. Esta LU la está utilizando actualmente otra aplicación.
CLU0_E_LUNOTFOUND La LU o el nombre del grupo no existen.
CLU0_E_TIMEDOUT La sesión no se inició dentro del tiempo de espera especificado.
CLU0_E_SESSION_FAILED La sesión no se pudo activar y no está conectada a ninguna sesión lu0 de TSS.

La aplicación debe intentar crear una nueva sesión con las mismas propiedades de conexión o diferentes, o bien conectarse a un identificador de sesión de TSS diferente.
CLU0_E_ACCESSDENIED La cuenta de usuario del cliente no tiene permiso para usar la LU o el grupo solicitados.
CLU0_E_ALREADY_CONNECTED El cliente comLU0 ya está conectado a otra sesión.
CLU0_E_SYSERROR Error debido a un error interno.

Observaciones

La tabla siguiente contiene los valores posibles para initType.

NOMBRE Valor Descripción
INIT_BIND 0 Espere a que bind y SDT no solicitados del OBJETO SEP.
INIT_SSCP 1 Espere a que lleguen BIND y SDT, pero permita el acceso a la sesión de SSCP para que la aplicación envíe datos y comandos de SSCP.
INIT_INITSELF 2 Espere a que un BIND y SDT lleguen después de enviar el comando INITSELF especificado en data.
INIT_LOGON 3 Espere a que un BIND y SDT lleguen después de enviar el mensaje de inicio de sesión de SSCP SIN FORMATO especificado en data.

Consulte también

Métodos de IcomLU0
Integrador de sesiones para LU0