HttpRemoveUrlFromUrlGroup-Funktion (http.h)

Artikel
03/06/2024

Die HttpRemoveUrlFromUrlGroup-Funktion entfernt die angegebene URL aus der Gruppe, die durch die URL-Gruppen-ID identifiziert wird. Diese Funktion entfernt eine oder alle URLs aus der Gruppe.

Diese Funktion ersetzt die HttpRemoveUrl-Funktion der HTTP-Version 1.0.

Syntax

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

Parameter

[in] UrlGroupId

Die ID der URL-Gruppe, aus der die in pFullyQualifiedUrl angegebene URL entfernt wird.

[in] pFullyQualifiedUrl

Ein Zeiger auf eine Unicode-Zeichenfolge, die eine ordnungsgemäß formatierte UrlPrefix-Zeichenfolge enthält, die die zu entfernende URL identifiziert.

Wenn HTTP_URL_FLAG_REMOVE_ALL im Flags-Parameter übergeben wird, werden alle vorhandenen URL-Registrierungen für die in UrlGroupId identifizierte URL-Gruppe aus der Gruppe entfernt. In diesem Fall muss pFullyQualifiedUrlNULL sein.

[in] Flags

Die URL-Flags qualifizieren die URL, die entfernt wird. Dies kann eines der folgenden Flags sein:

URL-Flag	Bedeutung
HTTP_URL_FLAG_REMOVE_ALL	Entfernt alle URLs, die derzeit bei der URL-Gruppe registriert sind.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird NO_ERROR zurückgegeben.

Wenn die Funktion fehlschlägt, gibt sie einen der folgenden Fehlercodes zurück.

Wert	Bedeutung
ERROR_INVALID_PARAMETER	Die URL-Gruppe ist nicht vorhanden. Der Flags-Parameter enthält eine ungültige Kombination von Flags. Das flag HTTP_URL_FLAG_REMOVE_ALL wurde festgelegt, und der pFullyQualifiedUrl-Parameter wurde nicht auf NULL festgelegt. Die Anwendung verfügt nicht über die Berechtigung zum Entfernen von URLs aus der Gruppe. Nur die Anwendung, die die URL-Gruppe erstellt hat, kann URLs entfernen.
ERROR_ACCESS_DENIED	Der aufrufende Prozess verfügt nicht über die Berechtigung zum Aufheben der Registrierung der URL.
ERROR_FILE_NOT_FOUND	Die angegebene URL ist nicht bei der URL-Gruppe registriert.

Wert

Bedeutung

ERROR_INVALID_PARAMETER

Die URL-Gruppe ist nicht vorhanden.

Der Flags-Parameter enthält eine ungültige Kombination von Flags.

Das flag HTTP_URL_FLAG_REMOVE_ALL wurde festgelegt, und der pFullyQualifiedUrl-Parameter wurde nicht auf NULL festgelegt.

Die Anwendung verfügt nicht über die Berechtigung zum Entfernen von URLs aus der Gruppe. Nur die Anwendung, die die URL-Gruppe erstellt hat, kann URLs entfernen.

ERROR_ACCESS_DENIED

Der aufrufende Prozess verfügt nicht über die Berechtigung zum Aufheben der Registrierung der URL.

ERROR_FILE_NOT_FOUND

Die angegebene URL ist nicht bei der URL-Gruppe registriert.

Hinweise

Die HTTP-Server-API unterstützt vorhandene Anwendungen, die die URL-Registrierungen der Version 1.0 verwenden. Neuentwicklungen mit der HTTP-Server-API sollten jedoch HttpRemoveUrlFromUrlGroup verwenden. Verwenden Sie httpRemoveUrl nicht.

Anwendungen sollten die URL entfernen, die der Gruppe von HttpAddUrlToUrlGroup hinzugefügt wurde, wenn die URL nicht mehr benötigt wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	http.h
Bibliothek	Httpapi.lib
DLL	Httpapi.dll