Funzione HttpCreateServerSession (http.h)

Articolo
08/24/2023

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
ERROR_REVISION_MISMATCH	La versione passata non è valida o non è supportata.
ERROR_INVALID_PARAMETER	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