Funzione HttpAddUrl (http.h)

La funzione HttpAddUrl registra un URL specificato in modo che le richieste corrispondenti vengano indirizzate a una coda di richiesta API HTTP Server specificata. Un'applicazione può registrare più URL in una singola coda di richieste usando chiamate ripetute a HttpAddUrl. Per altre informazioni sul modo in cui l'API server HTTP corrisponde agli URL di richiesta agli URL registrati, vedere UrlPrefix Strings.

A partire dall'API HTTP Server versione 2.0, le applicazioni devono chiamare HttpAddUrlToUrlGroup per registrare un URL; HttpAddUrl non deve essere usato.

Sintassi

HTTPAPI_LINKAGE ULONG HttpAddUrl(
  [in] HANDLE RequestQueueHandle,
  [in] PCWSTR FullyQualifiedUrl,
       PVOID  Reserved
);

Parametri

[in] RequestQueueHandle

Handle alla coda di richiesta a cui devono essere indirizzate le richieste per l'URL specificato. Viene creata una coda di richieste e il relativo handle restituito da una chiamata alla funzione HttpCreateRequestQueue .

Windows Server 2003 con SP1 e Windows XP con SP2: L'handle della coda della richiesta viene creato dalla funzione HttpCreateHttpHandle .

[in] FullyQualifiedUrl

Puntatore a una stringa Unicode contenente una stringa UrlPrefix corretta che identifica l'URL da registrare.

Reserved

Riservati; deve essere NULL.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore	Significato
ERROR_ACCESS_DENIED	L'applicazione chiamante non dispone dell'autorizzazione per registrare l'URL.
ERROR_DLL_INIT_FAILED	L'applicazione chiamante non ha chiamato HttpInitialize prima di chiamare questa funzione.
ERROR_INVALID_PARAMETER	Uno dei parametri non è valido.
ERROR_ALREADY_EXISTS	UrlPrefix specificato è in conflitto con una registrazione esistente.
ERROR_NOT_ENOUGH_MEMORY	Risorse insufficienti per completare l'operazione.
Altri	Codice di errore di sistema definito in WinError.h.

Commenti

Come indicato nell'argomento Stringhe urlPrefix , la specifica dello schema dell'URLPrefix da registrare deve essere "http" in minuscolo o "https". Nessun'altra sottostringa è valida.

Inoltre, non è possibile registrare GLI URL con schemi diversi nella stessa porta. Ovvero, gli schemi "http" e "https" non possono coesistere in una porta.

Tenere presente anche che HttpAddUrl registra qualsiasi urlPrefix passato a esso purché la stringa sia ben formata. Qualsiasi convalida di esistenza, accessibilità, proprietà o altra caratteristica dello spazio dei nomi URL specificato deve essere gestito dall'applicazione.

Per rilasciare le risorse allocate come risultato della registrazione eseguita da HttpAddUrl, effettuare una chiamata corrispondente alla funzione HttpRemoveUrl al termine dell'applicazione con lo spazio dei nomi coinvolto.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	http.h
Libreria	Httpapi.lib
DLL	Httpapi.dll

Vedi anche

Funzioni API SERVER HTTP versione 1.0

HttpAddUrlToUrlGroup

HttpRemoveUrl