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 dallo spazio. I nomi e i valori delle proprietà di connessione sono senza distinzione tra maiuscole e minuscole. Per altre informazioni sulle proprietà di connessione, vedere Proprietà sessione IcomLUO.
initType	Contiene il tipo di inizializzazione della sessione. Per ulteriori informazioni, vedere la sezione dei commenti.
data	Puntatore una matrice di tipo char senza segno contenente il messaggio di accesso INITSELF o SSCP. Usato solo se initType contiene INIT_INITSELF o INIT_LOGON.
timeout	Periodo di tempo in millisecondi per attendere l'arrivo dei comandi BIND e SDT. Se il timeout scade prima dell'arrivo di SDT, l'lu del server SNA verrà rilasciato e verrà restituito un errore. L'immissione 0xfffffff in timeout indica un tempo di attesa infinito.
sessionHandle	Quando questo metodo restituisce correttamente, contiene un puntatore all'interfaccia IUnknown all'oggetto sessione comLU0 che rappresenta la sessione LU0 sottostante. Insieme a un riferimento a questa interfaccia, l'oggetto 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, il server host o SNA potrebbe aver inviato un comando di accesso non formattato. Questo valore è true solo se initType è impostato su INIT_INITSELF o INIT_LOGON.
CLU0_E_BADPARM	connectionStr contiene un'impostazione di proprietà non valida.
CLU0_E_NOFREELU	L'lu specificato in luname è un pool lu del server SNA. Il pool non dispone attualmente di unità LUS gratuite.
CLU0_E_LUINUSE	L'lu specificato in luname è un server SNA LU. Questa lu è attualmente usata 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 a attivare e non è connessa a nessuna sessione LU0 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 per il client non dispone dell'autorizzazione per usare l'lu o il pool richiesti.
CLU0_E_ALREADY_CONNECTED	Il client comLU0 è già connesso a un'altra sessione.
CLU0_E_SYSERROR	Errore non riuscito a causa di un errore interno.

Commenti

La tabella seguente contiene i valori possibili per initType.

Nome	Valore	Descrizione
INIT_BIND	0	Attendere un binding non risolto e SDT dal PLU.
INIT_SSCP	1	Attendere l'arrivo di un oggetto BIND e SDT, ma consentire l'accesso alla sessione SSCP per l'applicazione per l'invio di dati e comandi SSCP.
INIT_INITSELF	2	Attendere l'arrivo di un oggetto BIND e SDT dopo l'invio del comando INITSELF specificato in data.
INIT_LOGON	3	Attendere l'arrivo di UN BINDING e SDT dopo l'invio del messaggio di accesso SSCP UNFORMATTED specificato in data.

Vedere anche

Metodi di IcomLU0
Session Integrator per LU0