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
ERROR_ACCESS_DENIED	L'applicazione chiamante non dispone dell'autorizzazione per rimuovere l'URL.
ERROR_INVALID_PARAMETER	Uno o più parametri forniti sono in formato inutilizzabile.
ERROR_NOT_ENOUGH_MEMORY	Risorse insufficienti per completare l'operazione.
ERROR_FILE_NOT_FOUND	Impossibile trovare l'URLPrefix specificato nel database di registrazione.
Altri	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

Vedi anche

Funzioni dell'API server HTTP versione 1.0

HttpAddUrl

HttpRemoveUrlFromUrlGroup