Función WinHttpConnectionDeletePolicyEntries

Quita todas las entradas de la directiva de enrutamiento de conexión asociadas a una etiqueta de directiva específica del servicio WinHTTP Auto-Proxy.

Syntax

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

Parameters

hSession [in]

Un identificador de sesión winHTTP válido creado por WinHttpOpen. El identificador debe ser un identificador de nivel de sesión.

PolicyEntryTag [in]

Identifica qué conjunto de entradas de directiva se van a quitar. Uno de los siguientes valores.

Value Meaning
TAG_WINHTTP_CONNECTION_POLICY_TAG_DEFAULT (0) Entradas de directiva predeterminadas o no etiquetadas.
TAG_WINHTTP_CONNECTION_POLICY_TAG_CONNECTION_MANAGER (1) Entradas administradas por el administrador de conexiones del sistema.
TAG_WINHTTP_CONNECTION_POLICY_TAG_WWWPT (2) Entradas administradas por el componente WWWPT (Windows Transporte de plataforma web).

Valor devuelto

Devuelve ERROR_SUCCESS (0) si se realiza correctamente. Devuelve un código de error del sistema en caso de error, incluido lo siguiente.

Value Description
ERROR_WINHTTP_INCORRECT_HANDLE_TYPE hSession no es un identificador de sesión.
ERROR_WINHTTP_NOT_INITIALIZED Los globales winHTTP no se inicializan.
ERROR_ACCESS_DENIED El autor de la llamada carece de privilegios necesarios.

Remarks

Nota:

Esta API no se incluye actualmente en un archivo de encabezado del SDK. Debe declarar la función usted mismo en el código.

Quita todas las entradas de directiva registradas previamente con la etiqueta especificada. Las entradas de otras etiquetas no se ven afectadas.

Normalmente se llama a antes de WinHttpConnectionSetPolicyEntries para garantizar una pizarra limpia al actualizar la directiva desde el componente propietario.

Esta API requiere privilegios elevados (administrador/SISTEMA).

Requisitos

Requirement Value
Cabecera N/A
Biblioteca winhttp.lib
DLL winhttp.dll

Consulte también