Funzione HttpCreateServerSession (http.h)
La funzione HttpCreateServerSession crea una sessione del server per la versione specificata.
Sintassi
HTTPAPI_LINKAGE ULONG HttpCreateServerSession(
[in] HTTPAPI_VERSION Version,
[out] PHTTP_SERVER_SESSION_ID ServerSessionId,
[in] ULONG Reserved
);
Parametri
[in] Version
Struttura HTTPAPI_VERSION che indica la versione della sessione del server. Per la versione 2.0, dichiarare un'istanza della struttura e impostarla sul valore predefinito HTTPAPI_VERSION_2 prima di passarla a HttpCreateServerSession.
La versione deve essere 2.0; HttpCreateServerSession non supporta le code di richieste della versione 1.0.
[out] ServerSessionId
Puntatore alla variabile che riceve l'ID della sessione del server.
[in] Reserved
Riservato. Deve essere zero.
Valore restituito
Se la funzione ha esito positivo, restituisce NO_ERROR.
Se la funzione ha esito negativo, restituisce uno dei codici di errore seguenti.
| Valore | Significato |
|---|---|
|
La versione passata non è valida o non è supportata. |
|
Il parametro pServerSessionId è null o reserved è diverso da zero. |
Commenti
Le sessioni del server possiedono un set di gruppi di URL. Sono contenitori di configurazione di primo livello per informazioni di configurazione applicabili a tutti i gruppi di URL creati in tali contenitori. Per altre informazioni sulla configurazione di una sessione del server, vedere HttpSetServerSessionProperty.
L'API server HTTP non supporta le operazioni di I/O asincrone per le sessioni del server.
Quando la sessione del server non è più necessaria o prima che l'applicazione termini, l'applicazione deve eliminare la sessione del server chiamando HttpCloseServerSession. Quando una sessione del server viene eliminata, vengono eliminati automaticamente anche tutti i gruppi di URL associati.
Requisiti
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | http.h |
| Libreria | Httpapi.lib |
| DLL | Httpapi.dll |
Vedi anche
Funzioni dell'API server HTTP versione 2.0