Funzione HttpAddUrlToUrlGroup (http.h)

Articolo
03/14/2023

La funzione HttpAddUrlToUrlGroup aggiunge l'URL specificato al gruppo di URL identificato dall'ID gruppo URL.

Questa funzione sostituisce la funzione HTTP versione 1.0 HttpAddUrl .

Sintassi

HTTPAPI_LINKAGE ULONG HttpAddUrlToUrlGroup(
  [in]           HTTP_URL_GROUP_ID UrlGroupId,
  [in]           PCWSTR            pFullyQualifiedUrl,
  [in, optional] HTTP_URL_CONTEXT  UrlContext,
  [in]           ULONG             Reserved
);

Parametri

[in] UrlGroupId

ID gruppo per il gruppo URL a cui vengono indirizzate le richieste per l'URL specificato. Il gruppo URL viene creato dalla funzione HttpCreateUrlGroup .

[in] pFullyQualifiedUrl

Puntatore a una stringa Unicode contenente una stringa UrlPrefix corretta che identifica l'URL da registrare. Se non si esegue come amministratore, specificare un numero di porta maggiore di 1024, in caso contrario, potrebbe essere visualizzato un errore di ERROR_ACCESS_DENIED.

[in, optional] UrlContext

Contesto associato all'URL registrato in questa chiamata. Il contesto URL viene restituito nella struttura HTTP_REQUEST con ogni richiesta ricevuta nell'URL specificato nel parametro pLyQualifiedUrl .

[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
ERROR_INVALID_PARAMETER	UrlGroupId non esiste. Il parametro Riservato non è zero. L'applicazione non dispone dell'autorizzazione per aggiungere URL al gruppo. Solo l'applicazione che ha creato il gruppo DI URL può aggiungere URL.
ERROR_ACCESS_DENIED	Il processo chiamante non dispone dell'autorizzazione per registrare l'URL.
ERROR_ALREADY_EXISTS	L'URL specificato è in conflitto con una registrazione esistente.

Valore

Significato

ERROR_INVALID_PARAMETER

UrlGroupId non esiste.

Il parametro Riservato non è zero.

L'applicazione non dispone dell'autorizzazione per aggiungere URL al gruppo. Solo l'applicazione che ha creato il gruppo DI URL può aggiungere URL.

ERROR_ACCESS_DENIED

Il processo chiamante non dispone dell'autorizzazione per registrare l'URL.

ERROR_ALREADY_EXISTS

L'URL specificato è in conflitto con una registrazione esistente.

Commenti

L'API server HTTP supporta le applicazioni esistenti usando le registrazioni URL versione 1.0, tuttavia, la nuova sviluppo con l'API server HTTP deve usare HttpAddUrlToUrlGroup; HttpAddUrl non deve essere usato.

Un'applicazione può aggiungere più URL a un gruppo di URL usando chiamate ripetute a HttpAddUrlToUrlGroup. Le richieste che corrispondono all'URL specificato vengono indirizzate alla coda di richiesta associata al gruppo URL. Per altre informazioni sul modo in cui l'API server HTTP corrisponde agli URL di richiesta agli URL registrati, vedere UrlPrefix Strings.

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