Funzione HttpRemoveUrl (http.h)
La funzione HttpRemoveUrl fa sì che il sistema interrompa il routing delle richieste che corrispondono a una stringa UrlPrefix specificata a una coda di richieste specificata.
A partire dall'API SERVER HTTP versione 2.0, le applicazioni devono chiamare HttpRemoveUrlFromUrlGroup per registrare un URL; HttpRemoveUrl non deve essere usato.
Sintassi
HTTPAPI_LINKAGE ULONG HttpRemoveUrl(
[in] HANDLE RequestQueueHandle,
[in] PCWSTR FullyQualifiedUrl
);
Parametri
[in] RequestQueueHandle
Handle per la coda di richieste da cui rimuovere la registrazione dell'URL. 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 per la coda di richieste viene creato dalla funzione HttpCreateHttpHandle .
[in] FullyQualifiedUrl
Puntatore a una stringa UrlPrefix registrata nella coda di richieste specificata. Questa stringa deve essere identica a quella passata a HttpAddUrl per registrare urlPrefix; anche una modifica della denominazione in un indirizzo IPv6 non è accettata.
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.
Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.
| Valore | Significato |
|---|---|
|
L'applicazione chiamante non dispone dell'autorizzazione per rimuovere l'URL. |
|
Uno o più parametri forniti sono in formato inutilizzabile. |
|
Risorse insufficienti per completare l'operazione. |
|
Impossibile trovare l'URLPrefix specificato nel database di registrazione. |
|
Codice di errore di sistema definito in WinError.h. |
Requisiti
| 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 |