Funzione HttpRemoveUrlFromUrlGroup (http.h)

Articolo
02/29/2024

La funzione HttpRemoveUrlFromUrlGroup rimuove l'URL specificato dal gruppo identificato dall'ID gruppo url. Questa funzione rimuove uno o tutti gli URL dal gruppo.

Questa funzione sostituisce la funzione HTTP versione 1.0 HttpRemoveUrl .

Sintassi

HTTPAPI_LINKAGE ULONG HttpRemoveUrlFromUrlGroup(
  [in] HTTP_URL_GROUP_ID UrlGroupId,
  [in] PCWSTR            pFullyQualifiedUrl,
  [in] ULONG             Flags
);

Parametri

[in] UrlGroupId

ID del gruppo di URL da cui viene rimosso l'URL specificato in pFullyQualifiedUrl .

[in] pFullyQualifiedUrl

Puntatore a una stringa Unicode che contiene una stringa UrlPrefix correttamente formata che identifica l'URL da rimuovere.

Quando HTTP_URL_FLAG_REMOVE_ALL viene passato nel parametro Flags , tutte le registrazioni URL esistenti per il gruppo di URL identificato in UrlGroupId vengono rimosse dal gruppo. In questo caso , pFullyQualifiedUrl deve essere NULL.

[in] Flags

Flag URL che qualificano l'URL rimosso. Può trattarsi di uno dei flag seguenti:

URL Flag	Significato
HTTP_URL_FLAG_REMOVE_ALL	Rimuove tutti gli URL attualmente registrati con il gruppo di URL.

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	Il gruppo di URL non esiste. Il parametro Flags contiene una combinazione non valida di flag. Il flag HTTP_URL_FLAG_REMOVE_ALL è stato impostato e il parametro pFullyQualifiedUrl non è stato impostato su NULL. L'applicazione non dispone dell'autorizzazione per rimuovere gli URL dal gruppo. Solo l'applicazione che ha creato il gruppo di URL può rimuovere gli URL.
ERROR_ACCESS_DENIED	Il processo chiamante non dispone dell'autorizzazione per annullare la registrazione dell'URL.
ERROR_FILE_NOT_FOUND	L'URL specificato non è registrato con il gruppo di URL.

Valore

Significato

ERROR_INVALID_PARAMETER

Il gruppo di URL non esiste.

Il parametro Flags contiene una combinazione non valida di flag.

Il flag HTTP_URL_FLAG_REMOVE_ALL è stato impostato e il parametro pFullyQualifiedUrl non è stato impostato su NULL.

L'applicazione non dispone dell'autorizzazione per rimuovere gli URL dal gruppo. Solo l'applicazione che ha creato il gruppo di URL può rimuovere gli URL.

ERROR_ACCESS_DENIED

Il processo chiamante non dispone dell'autorizzazione per annullare la registrazione dell'URL.

ERROR_FILE_NOT_FOUND

L'URL specificato non è registrato con il gruppo di URL.

Commenti

L'API server HTTP supporta le applicazioni esistenti che usano le registrazioni URL della versione 1.0, ma il nuovo sviluppo con l'API server HTTP deve usare HttpRemoveUrlFromUrlGroup; non usare HttpRemoveUrl.

Le applicazioni devono rimuovere l'URL aggiunto al gruppo da HttpAddUrlToUrlGroup, quando l'URL non è più necessario.

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