Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
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 |
|---|---|
|
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. |
|
Der aufrufende Prozess verfügt nicht über die Berechtigung zum Aufheben der Registrierung der URL. |
|
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 |