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 HttpRemoveUrl-Funktion bewirkt, dass das System das Routing von Anforderungen beendet, die einer angegebenen UrlPrefix-Zeichenfolge mit einer angegebenen Anforderungswarteschlange entsprechen.
Ab Version 2.0 der HTTP-Server-API sollten Anwendungen HttpRemoveUrlFromUrlGroup aufrufen, um eine URL zu registrieren. HttpRemoveUrl sollte nicht verwendet werden.
Syntax
HTTPAPI_LINKAGE ULONG HttpRemoveUrl(
[in] HANDLE RequestQueueHandle,
[in] PCWSTR FullyQualifiedUrl
);
Parameter
[in] RequestQueueHandle
Das Handle für die Anforderungswarteschlange, aus der die URL-Registrierung entfernt werden soll. Eine Anforderungswarteschlange wird erstellt, und ihr Handle wird durch einen Aufruf der HttpCreateRequestQueue-Funktion zurückgegeben.
Windows Server 2003 mit SP1 und Windows XP mit SP2: Das Handle für die Anforderungswarteschlange wird von der HttpCreateHttpHandle-Funktion erstellt.
[in] FullyQualifiedUrl
Ein Zeiger auf eine UrlPrefix-Zeichenfolge , die für die angegebene Anforderungswarteschlange registriert ist. Diese Zeichenfolge muss mit der an HttpAddUrl übergebenen Zeichenfolge identisch sein, um urlPrefix zu registrieren. auch eine Nomenklaturänderung in einer IPv6-Adresse wird nicht akzeptiert.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.
Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.
| Wert | Bedeutung |
|---|---|
|
Die aufrufende Anwendung verfügt nicht über die Berechtigung zum Entfernen der URL. |
|
Mindestens einer der angegebenen Parameter ist in einer nicht verwendbaren Form. |
|
Unzureichende Ressourcen, um den Vorgang abzuschließen. |
|
Der angegebene UrlPrefix konnte in der Registrierungsdatenbank nicht gefunden werden. |
|
Ein in WinError.h definierter Systemfehlercode . |
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista, Windows XP mit SP2 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | http.h |
| Bibliothek | Httpapi.lib |
| DLL | Httpapi.dll |