WinHttpConnectionDeletePolicyEntries-Funktion

Entfernt alle Verbindungsroutingrichtlinieneinträge, die einem bestimmten Richtlinientag zugeordnet sind, aus dem WinHTTP-Autoproxydienst.

Syntax

DWORD WINAPI WinHttpConnectionDeletePolicyEntries(
    _In_ HINTERNET                      hSession,
    _In_ WINHTTP_CONNECTION_POLICY_TAG  PolicyEntryTag
);

Parameter

hSession [in]

Ein gültiges WinHTTP-Sitzungshandle, das von WinHttpOpen erstellt wurde. Das Handle muss ein Handle auf Sitzungsebene sein.

PolicyEntryTag [in]

Gibt an, welche Gruppe von Richtlinieneinträgen entfernt werden sollen. Einer der folgenden Werte.

Wert	Bedeutung
TAG_WINHTTP_CONNECTION_POLICY_TAG_DEFAULT (0)	Standard-/nicht markierte Richtlinieneinträge.
TAG_WINHTTP_CONNECTION_POLICY_TAG_CONNECTION_MANAGER (1)	Vom Systemverbindungs-Manager verwaltete Einträge.
TAG_WINHTTP_CONNECTION_POLICY_TAG_WWWPT (2)	Einträge, die von der WWWPT-Komponente (Windows Web Platform Transport) verwaltet werden.

Rückgabewert

Gibt ERROR_SUCCESS (0) bei Erfolg zurück. Gibt einen Systemfehlercode für Fehler zurück, einschließlich der folgenden.

Wert	Beschreibung
ERROR_WINHTTP_INCORRECT_HANDLE_TYPE	hSession ist kein Sitzungshandle.
ERROR_WINHTTP_NOT_INITIALIZED	WinHTTP-Globalen werden nicht initialisiert.
ERROR_ACCESS_DENIED	Der Aufrufer verfügt nicht über erforderliche Berechtigungen.

Remarks

Note

Diese API ist derzeit nicht in einer SDK-Headerdatei enthalten. Sie müssen die Funktion selbst in Ihrem Code deklarieren.

Entfernt alle Richtlinieneinträge, die zuvor mit dem angegebenen Tag registriert wurden. Die Einträge anderer Tags bleiben unberührt.

Wird in der Regel vor WinHttpConnectionSetPolicyEntries aufgerufen, um beim Aktualisieren der Richtlinie aus der eigenen Komponente eine saubere Schiefer zu gewährleisten.

Für diese API sind erhöhte Rechte (Administrator/SYSTEM) erforderlich.

Anforderungen

Anforderung	Wert
Header	N/A
Bibliothek	winhttp.lib
DLL	winhttp.dll

Siehe auch

• WinHttpConnectionSetPolicyEntries
• WinHttpOpen