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", delimitado por espacio. Los nombres y valores de las propiedades de conexión no distinguen mayúsculas de 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. Solo se usa si initType contiene INIT_INITSELF o INIT_LOGON.
timeout	Período de tiempo en milisegundos para esperar a que lleguen los comandos BIND y SDT. Si el tiempo de espera expira antes de que el SDT llegue a la LU del servidor SNA se liberará y se devolverá un error. Entrar 0xfffffff en timeout indica 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 al método IcomLU0.Connect 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 para CreateSession.

Value	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 host o el servidor SNA enviaron una respuesta negativa al INITSELF. Opcionalmente, el host o el servidor SNA pueden haber enviado un comando de inicio de sesión sin formato. Esto solo es true si initType se establece INIT_INITSELF en o INIT_LOGON.
CLU0_E_BADPARM	connectionStr contenía un valor de propiedad no válido.
CLU0_E_NOFREELU	La LU especificada en luname es un grupo de LU de servidor SNA. El grupo no tiene actualmente ninguna LU gratuita.
CLU0_E_LUINUSE	La LU especificada en luname es una LU de servidor SNA. Actualmente, otra aplicación está usando esta LU.
CLU0_E_LUNOTFOUND	El nombre de lu o grupo no existe.
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 otro identificador de sesión de TSS.
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.

Comentarios

La tabla siguiente contiene los valores posibles para initType.

Nombre	Value	Descripción
INIT_BIND	0	Espere a que un BIND y SDT no solicitados de la PLU.
INIT_SSCP	1	Espere a que llegue 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 llegue bind y SDT después de enviar el comando INITSELF especificado en data.
INIT_LOGON	3	Espere a que llegue bind y SDT después de enviar el mensaje de inicio de sesión de SSCP UNFORMATTED especificado en data.

Consulte también

Métodos de IcomLU0
Integrador de sesiones para LU0