Funzione HttpSetServerSessionProperty (http.h)

Articolo
08/24/2023

La funzione HttpSetServerSessionProperty imposta una nuova proprietà sessione del server o modifica una proprietà esistente nella sessione del server specificata.

Sintassi

HTTPAPI_LINKAGE ULONG HttpSetServerSessionProperty(
  [in] HTTP_SERVER_SESSION_ID ServerSessionId,
  [in] HTTP_SERVER_PROPERTY   Property,
  [in] PVOID                  PropertyInformation,
  [in] ULONG                  PropertyInformationLength
);

Parametri

[in] ServerSessionId

Sessione del server per cui è impostata la proprietà.

[in] Property

Membro dell'enumerazione HTTP_SERVER_PROPERTY che descrive il tipo di proprietà impostato. Questo può essere uno dei seguenti.

Proprietà	Significato
HttpServerStateProperty	Modifica o imposta lo stato della sessione del server. Lo stato può essere abilitato o disabilitato; lo stato predefinito è abilitato.
HttpServerTimeoutsProperty	Modifica o imposta i limiti di timeout della connessione della sessione del server.
HttpServerQosProperty	Modifica o imposta la limitazione della larghezza di banda per la sessione del server. Per impostazione predefinita, l'API server HTTP non limita la larghezza di banda. Nota Questo valore esegue il mapping alla struttura di HTTP_QOS_SETTING_INFO generica con QosType impostata su HttpQosSettingTypeBandwidth.
HttpServerLoggingProperty	Abilita o disabilita la registrazione per la sessione del server. Questa proprietà imposta solo la registrazione binaria W3C centralizzata e centralizzata. Per impostazione predefinita, la registrazione non è abilitata.
HttpServerAuthenticationProperty	Abilita l'autenticazione lato server in modalità kernel per gli schemi di autenticazione basic, NTLM, Negotiate e Digest.
HttpServerExtendedAuthenticationProperty	Abilita l'autenticazione lato server in modalità kernel per lo schema di autenticazione Kerberos.
HttpServerChannelBindProperty	Abilita l'autenticazione lato server che usa un token di associazione del canale (CBT).

[in] PropertyInformation

Puntatore al buffer contenente i dati delle proprietà.

pPropertyInformation punta a una struttura di dati delle proprietà, elencata nella tabella seguente, in base alla proprietà impostata.

Proprietà	Struttura
HttpServerStateProperty	HTTP_STATE_INFO
HttpServerLoggingProperty	HTTP_LOGGING_INFO
HttpServerQosProperty	HTTP_QOS_SETTING_INFO
HttpServerTimeoutsProperty	HTTP_TIMEOUT_LIMIT_INFO
HttpServerAuthenticationProperty	HTTP_SERVER_AUTHENTICATION_INFO
HttpServerExtendedAuthenticationProperty	HTTP_SERVER_AUTHENTICATION_INFO
HttpServerChannelBindProperty	HTTP_CHANNEL_BIND_INFO

[in] PropertyInformationLength

Lunghezza, in byte, del buffer a cui fa riferimento il parametro pPropertyInformation .

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_INVALID_PARAMETER	Il tipo di proprietà specificato nel parametro Property non è supportato per le sessioni del server. Il parametro pPropertyInformation è NULL. Il parametro PropertyInformationLength è zero. Il parametro ServerSessionId non contiene una sessione server valida. L'applicazione non dispone dell'autorizzazione per impostare le proprietà della sessione del server. Solo l'applicazione che ha creato la sessione del server può impostare le proprietà.

Valore

Significato

ERROR_INVALID_PARAMETER

Il tipo di proprietà specificato nel parametro Property non è supportato per le sessioni del server.

Il parametro pPropertyInformation è NULL.

Il parametro PropertyInformationLength è zero.

Il parametro ServerSessionId non contiene una sessione server valida.

L'applicazione non dispone dell'autorizzazione per impostare le proprietà della sessione del server. Solo l'applicazione che ha creato la sessione del server può impostare le proprietà.

Commenti

Le sessioni server sono contenitori di configurazione di primo livello per i dati di configurazione che si applicano a tutti i gruppi di URL creati in loro. La sessione del server viene creata con HttpCreateServerSession.

Il parametro pPropertyInformation punta alla struttura di configurazione per il tipo di proprietà impostato. Il parametro PropertyInformationLength specifica le dimensioni, in byte, della struttura di configurazione. Ad esempio, quando si imposta il parametro HttpServerTimeoutsProperty il parametro pPropertyInformation deve puntare a un buffer che è almeno uguale alla dimensione della struttura HTTP_TIMEOUT_LIMIT_INFO .

Requisiti

Requisito	Valore
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 API SERVER HTTP versione 2.0

HttpCloseServerSession

HttpCreateServerSession

HttpQueryServerSessionProperty

HttpSetServerSessionProperty