Condividi tramite

Metodo IcomLUO.CreateSession

Crea una nuova sessione LU0.

Sintassi

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

Parametri

Parametro Descrizione
connectionSTR Stringa con terminazione NULL che indica le proprietà di connessione della nuova sessione. La stringa viene presentata in un formato "PROPERTY=VALUE", delimitato da spazi. I nomi e i valori delle proprietà di connessione non fanno distinzione tra maiuscole e minuscole. Per altre informazioni sulle proprietà di connessione, vedere Proprietà di sessione IcomLUO.
initType Contiene il tipo di inizializzazione della sessione. Per altre informazioni, vedere la sezione Commenti.
data Puntatore una matrice di tipo char senza segno che contiene il messaggio di accesso INITSELF o SSCP. Utilizzato solo se initType contiene INIT_INITSELF o INIT_LOGON.
timeout Periodo di tempo in millisecondi di attesa per l'arrivo dei comandi BIND e SDT. Se il timeout scade prima che l'arrivo di SDT, la LU del server SNA verrà rilasciata e verrà restituito un errore.

L'immissione di 0xfffffff in timeout indica un tempo di attesa infinito.
sessionHandle Quando questo metodo termina con successo, contiene un puntatore all'interfaccia IUnknown dell'oggetto di sessione comLU0 che rappresenta la sessione LU0 sottostante. Finché si mantiene un riferimento a questa interfaccia, l'oggetto di sessione rimarrà intatto.

Questa interfaccia può essere passata al metodo IcomLU0.Connect per connettersi all'oggetto comLU0 con la sessione.

Se non viene specificata alcuna proprietà LU, comLU0 selezionerà il lu migliore disponibile assegnato all'account utente in cui è in esecuzione.

Valore restituito

Nella tabella seguente vengono descritti i codici restituiti per CreateSession.

Valore Descrizione
S_OK La sessione LU0 è stata creata correttamente. La sessione lu è attiva e pronta per ricevere l'input.
CLU0_S_SSCP_ACTIVE La sessione LU0 è stata creata correttamente. La sessione SSCP è attiva e pronta per ricevere l'input.

Questo codice restituito è valido solo quando initType è impostato su INIT_SSCP.
CLU0_E_NEG_RESPONSE L'host o il server SNA hanno inviato una risposta negativa a INITSELF.

Facoltativamente, l'host o il server SNA potrebbero aver inviato un comando di accesso non formattato. Questo vale solo se initType è impostato su INIT_INITSELF o INIT_LOGON.
CLU0_E_BADPARM connectionStr contiene un'impostazione di proprietà non valida.
CLU0_E_NOFREELU La LU specificata in luname è un pool di LU del server SNA. Il pool non dispone attualmente di LUs liberi.
CLU0_E_LUINUSE L'LU specificato in luname è un LU server SNA. Questo LU è attualmente in uso da un'altra applicazione.
CLU0_E_LUNOTFOUND Il nome lu o pool non esiste.
CLU0_E_TIMEDOUT La sessione non è stata avviata entro il timeout specificato.
CLU0_E_SESSION_FAILED La sessione non è riuscita ad attivarsi e non è connessa ad alcuna sessione LU0 di TSS.

L'applicazione deve tentare di creare una nuova sessione usando le stesse proprietà di connessione o diversa oppure connettersi a un handle di sessione TSS diverso.
CLU0_E_ACCESSDENIED L'account utente del client non ha l'autorizzazione per l'uso dell'unità logica (LU) o del pool richiesto.
CLU0_E_ALREADY_CONNECTED Il client comLU0 è già connesso a un'altra sessione.
CLU0_E_SYSERROR Non riuscito a causa di un errore interno.

Osservazioni:

La tabella seguente contiene i valori possibili per initType.

Nome Valore Descrizione
INIT_BIND 0 Attendere un BIND e un SDT non sollecitati dalla PLU.
INIT_SSCP 1 Attendere l'arrivo di bind e SDT, ma consentire l'accesso alla sessione SSCP affinché l'applicazione invii dati e comandi SSCP.
INIT_INITSELF 2 Attendere l'arrivo di bind e SDT dopo l'invio del comando INITSELF specificato in data.
INIT_LOGON 3 Attendere l'arrivo di BIND e SDT dopo l'invio del messaggio di accesso SSCP "UNFORMATTED" specificato in data.

Vedere anche

Metodi IcomLU0
Session Integrator per LU0

  • Last updated on