Funzione HttpCreateUrlGroup (http.h)
La funzione HttpCreateUrlGroup crea un gruppo di URL nella sessione del server specificata.
Sintassi
HTTPAPI_LINKAGE ULONG HttpCreateUrlGroup(
[in] HTTP_SERVER_SESSION_ID ServerSessionId,
[out] PHTTP_URL_GROUP_ID pUrlGroupId,
[in] ULONG Reserved
);
Parametri
[in] ServerSessionId
Identificatore della sessione del server in cui viene creato il gruppo di URL.
[out] pUrlGroupId
Puntatore alla variabile che riceve l'ID del gruppo di URL.
[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 |
|---|---|
|
Il parametro ServerSessionId indica una sessione server non esistente.
Il parametro pUrlGroupId è null. Il parametro Reserved è diverso da zero. |
Commenti
I gruppi URL sono contenitori di configurazione per un set di URL. Vengono creati nella sessione del server e ereditano le impostazioni di configurazione della sessione del server. Quando un parametro di configurazione viene impostato nel gruppo di URL, esegue l'override del set di configurazione nella sessione del server. Per altre informazioni sulle configurazioni delle impostazioni per il gruppo di URL, vedere HttpSetUrlGroupProperty.
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 del server HTTP genera una risposta 503.
L'associazione del gruppo URL a una coda di richieste è dinamica. L'associazione con la sessione dei server non può essere modificata fino a quando non viene eliminata la sessione del server o il gruppo di URL. Quando una sessione del server viene eliminata, vengono chiusi automaticamente anche tutti i gruppi di URL associati.
Il gruppo url viene inizialmente creato come gruppo vuoto. Gli URL devono essere aggiunti al gruppo chiamando HttpAddUrlToUrlGroup.
L'applicazione può creare più gruppi di URL per i motivi seguenti:
- Per impostare configurazioni distinte per parti diverse dello spazio dei nomi URL in cui è in ascolto.
- Per impostare code di richieste separate per parti diverse dello spazio dei nomi URL in cui è in ascolto.
Le applicazioni devono combinare gli URL in gruppi il più possibile; in caso contrario, le prestazioni peggiorano e aumentano il consumo di memoria del sistema influiranno sulla scalabilità.
L'API server HTTP non supporta l'I/O asincrona nei gruppi di URL.
Quando il gruppo di URL non è più necessario o prima che l'applicazione termini, è necessario eliminare il gruppo di URL chiamando HttpCloseUrlGroup.
Il gruppo di URL viene creato con la stessa versione della sessione del server in cui viene creata.
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 |