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. |