Scopo
Avvia una sessione server con il nome specificato; se esiste già una sessione con lo stesso nome la funzione non fa nulla.
Sintassi
boolean created = startSession("nome sessione", "query string")
Argomenti
Nome Sessione | Nome che si vuole dare alla nuova sessione |
Query String | QueryString con cui far partire la sessione (ad esempio CMD=wait&SEC=30) |
Valore di ritorno
Viene ritornato True se la sessione è stata creata; viene restituito False se esisteva già una sessione con tale nome.
Esempio di codice
// ***********************
// Crea una nuova sessione
// ***********************
public void SessionMonitor.Creanuovasessione()
{
// Se è stato specificato un nome
if (length(EsempiMS.NuovaSessione.NomeSessione) > 0)
{
// Provo a creare una sessione server con il nome fornito
if (!(startSession(EsempiMS.NuovaSessione.NomeSessione, EsempiMS.
NuovaSessione.QueryString)))
{
ServerSessionsLog.setInfoMessage(WARN, "Esiste già una sessione con
nome '" + EsempiMS.NuovaSessione.NomeSessione + "'", ...)
}
else
{
// Imposto una priorità bassa per la sessione creata
EsempiMS.setLowSessionPriority(EsempiMS.NuovaSessione.NomeSessione
, [low])
}
}
}
// Crea una nuova sessione
// ***********************
public void SessionMonitor.Creanuovasessione()
{
// Se è stato specificato un nome
if (length(EsempiMS.NuovaSessione.NomeSessione) > 0)
{
// Provo a creare una sessione server con il nome fornito
if (!(startSession(EsempiMS.NuovaSessione.NomeSessione, EsempiMS.
NuovaSessione.QueryString)))
{
ServerSessionsLog.setInfoMessage(WARN, "Esiste già una sessione con
nome '" + EsempiMS.NuovaSessione.NomeSessione + "'", ...)
}
else
{
// Imposto una priorità bassa per la sessione creata
EsempiMS.setLowSessionPriority(EsempiMS.NuovaSessione.NomeSessione
, [low])
}
}
}
- Il parametro QueryString, dopo che la sessione è stata inizializzata, viene analizzato e, come avviene per le richieste normali, se inizia per "CMD=" viene notificato l'evento OnCommand. I parametri sono recuperabili tramite la funzione GetURLParam.
- Le sessioni server sono condivise da tutte le sessioni utente.
- La sessione rimarrà "viva" finché non verrà terminata tramite la funzione EndSession.
- Questa funzione ha il solo compito di avviare la sessione; essa ritorna subito senza aspettare che la sessione abbia completato il comando eventualmente fornitogli tramite il parametro QueryString.
Ultima modifica: 25/10/2016 / Validità: da 9.5.4160