Funzione HttpSetUrlGroupProperty (http.h)

Articolo
08/24/2023

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
HttpServerAuthenticationProperty	Abilita l'autenticazione lato server per il gruppo di URL usando gli schemi di autenticazione Basic, NTLM, Negozia e Digest.
HttpServerExtendedAuthenticationProperty	Abilita l'autenticazione lato server per il gruppo di URL usando lo schema di autenticazione Kerberos.
HttpServerQosProperty	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.
HttpServerBindingProperty	Modifica o imposta l'associazione del gruppo di URL con una coda di richieste.
HttpServerLoggingProperty	Modifica o imposta la registrazione per il gruppo DI URL.
HttpServerStateProperty	Modifica o imposta lo stato del gruppo DI URL. Lo stato può essere abilitato o disabilitato.
HttpServerTimeoutsProperty	Modifica o imposta i limiti di timeout di connessione per il gruppo DI URL.
HttpServerChannelBindProperty	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
ERROR_INVALID_PARAMETER	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à.

Valore

Significato

ERROR_INVALID_PARAMETER

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