HttpRemoveUrl-Funktion (http.h)
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 |