Start Session

funzione link

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])
    }
  }
}

Ultima modifica: 25/10/2016 / Validità: da 9.5.4160

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.