Funzione HttpSetServerSessionProperty (http.h)
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 |
|---|---|
|
Modifica o imposta lo stato della sessione del server. Lo stato può essere abilitato o disabilitato; lo stato predefinito è abilitato. |
|
Modifica o imposta i limiti di timeout della connessione della sessione del server. |
|
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.
|
|
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. |
|
Abilita l'autenticazione lato server in modalità kernel per gli schemi di autenticazione basic, NTLM, Negotiate e Digest. |
|
Abilita l'autenticazione lato server in modalità kernel per lo schema di autenticazione Kerberos. |
|
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 |
|---|---|
|
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