Condividi tramite


Funzione HttpRemoveUrlFromUrlGroup (http.h)

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.

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

Vedi anche

Funzioni dell'API server HTTP versione 2.0

HttpAddUrlToUrlGroup

HttpCloseUrlGroup

HttpCreateUrlGroup

HttpQueryUrlGroupProperty

HttpRemoveUrl

HttpSetUrlGroupProperty