Funzione HttpSetUrlGroupProperty (http.h)
La funzione HttpSetUrlGroupProperty imposta una nuova proprietà o modifica una proprietà esistente nel gruppo URL specificato.
Sintassi
HTTPAPI_LINKAGE ULONG HttpSetUrlGroupProperty(
[in] HTTP_URL_GROUP_ID UrlGroupId,
[in] HTTP_SERVER_PROPERTY Property,
[in] PVOID PropertyInformation,
[in] ULONG PropertyInformationLength
);
Parametri
[in] UrlGroupId
ID del gruppo URL per cui è impostata la proprietà.
[in] Property
Membro dell'enumerazione HTTP_SERVER_PROPERTY che descrive il tipo di proprietà modificato o impostato. I possibili valori sono i seguenti:
| Proprietà | Significato |
|---|---|
|
Abilita l'autenticazione lato server per il gruppo di URL usando gli schemi di autenticazione Basic, NTLM, Negozia e Digest. |
|
Abilita l'autenticazione lato server per il gruppo di URL usando lo schema di autenticazione Kerberos. |
|
Questo valore esegue il mapping alla struttura di HTTP_QOS_SETTING_INFO generica con QosType impostata su HttpQosSettingTypeBandwidth o HttpQosSettingTypeConnectionLimit. Se HttpQosSettingTypeBandwidth, modifica o imposta la limitazione della larghezza di banda per il gruppo di URL. Se HttpQosSettingTypeConnectionLimit, modifica o imposta il numero massimo di connessioni in sospeso servite per un gruppo di URL in qualsiasi momento. |
|
Modifica o imposta l'associazione del gruppo di URL con una coda di richieste. |
|
Modifica o imposta la registrazione per il gruppo DI URL. |
|
Modifica o imposta lo stato del gruppo DI URL. Lo stato può essere abilitato o disabilitato. |
|
Modifica o imposta i limiti di timeout di connessione per il gruppo DI URL. |
|
Abilita l'autenticazione lato server che usa un token di associazione del canale (CBT). |
[in] PropertyInformation
Puntatore al buffer contenente le informazioni sulla proprietà.
pPropertyInformation punta a una delle strutture di informazioni sulle proprietà seguenti in base alla proprietà impostata.
| Proprietà | Struttura |
|---|---|
| HttpServerAuthenticatonProperty | HTTP_SERVER_AUTHENTICATION_INFO |
| HttpServerExtendedAuthenticationProperty | HTTP_SERVER_AUTHENTICATION_INFO |
| HttpServerQosProperty | HTTP_QOS_SETTING_INFO |
| HttpServerBindingProperty | HTTP_BINDING_INFO |
| HttpServerLoggingProperty | HTTP_LOGGING_INFO |
| HttpServerStateProperty | HTTP_STATE_INFO |
| HttpServerTimeoutsProperty | HTTP_TIMEOUT_LIMIT_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 i gruppi di URL.
Il parametro pPropertyInformation è NULL. Il parametro PropertyInformationLength è zero. Il parametro UrlGroupId non contiene una sessione del server valida. L'applicazione non dispone dell'autorizzazione per impostare le proprietà del gruppo di URL. Solo l'applicazione che ha creato il gruppo DI URL può impostare le proprietà. |
Commenti
Dopo aver creato il gruppo di URL, deve essere associato a una coda di richieste per ricevere le richieste. Per associare il gruppo DI URL a una coda di richieste, l'applicazione chiama HttpSetUrlGroupProperty con la proprietà HttpServerBindingProperty . Se questa proprietà non è impostata, le richieste corrispondenti per il gruppo di URL non vengono recapitate a una coda di richieste e l'API server HTTP genera una risposta 503.
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 |