HttpRemoveUrl-Funktion (http.h)

  • Artikel

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
ERROR_ACCESS_DENIED
 Die aufrufende Anwendung verfügt nicht über die Berechtigung zum Entfernen der URL.
ERROR_INVALID_PARAMETER
 Mindestens einer der angegebenen Parameter ist in einer nicht verwendbaren Form.
ERROR_NOT_ENOUGH_MEMORY
 Unzureichende Ressourcen, um den Vorgang abzuschließen.
ERROR_FILE_NOT_FOUND
 Der angegebene UrlPrefix konnte in der Registrierungsdatenbank nicht gefunden werden.
Andere
 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

Weitere Informationen

Funktionen der HTTP-Server-API, Version 1.0

HttpAddUrl

HttpRemoveUrlFromUrlGroup