Função WinHttpConnectionDeletePolicyEntries

Remove todas as entradas de política de roteamento de conexão associadas a uma marca de política específica do Serviço de Proxy Automático WinHTTP.

Sintaxe

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

Parameters

hSession [in]

Um identificador de sessão WinHTTP válido criado pelo WinHttpOpen. O identificador deve ser um identificador no nível da sessão.

PolicyEntryTag [in]

Identifica qual conjunto de entradas de política deve ser removido. Um dos valores a seguir.

Valor	Meaning
TAG_WINHTTP_CONNECTION_POLICY_TAG_DEFAULT (0)	Entradas de política padrão/não registradas.
TAG_WINHTTP_CONNECTION_POLICY_TAG_CONNECTION_MANAGER (1)	Entradas gerenciadas pelo gerenciador de conexões do sistema.
TAG_WINHTTP_CONNECTION_POLICY_TAG_WWWPT (2)	Entradas gerenciadas pelo componente WWWPT (Windows Web Platform Transport).

Valor de devolução

Retorna ERROR_SUCCESS (0) com êxito. Retorna um código de erro do sistema sobre falha, incluindo o seguinte.

Valor	Descrição
ERROR_WINHTTP_INCORRECT_HANDLE_TYPE	hSession não é um identificador de sessão.
ERROR_WINHTTP_NOT_INITIALIZED	Os globais do WinHTTP não são inicializados.
ERROR_ACCESS_DENIED	O chamador não tem privilégios necessários.

Remarks

Observação

No momento, essa API não está incluída em um arquivo de cabeçalho do SDK. Você deve declarar a função por conta própria em seu código.

Remove todas as entradas de política registradas anteriormente com a marca especificada. As entradas de outras marcas permanecem não afetadas.

Normalmente chamado antes de WinHttpConnectionSetPolicyEntries para garantir uma ardósia limpa ao atualizar a política do componente proprietário.

Essa API requer privilégios elevados (administrador/SISTEMA).

Requisitos

Requisito	Valor
Header	N/A
Biblioteca	winhttp.lib
DLL	winhttp.dll

Consulte também

• WinHttpConnectionSetPolicyEntries
• WinHttpOpen