Funzione WinHttpConnectionDeletePolicyEntries

Rimuove tutte le voci dei criteri di routing delle connessioni associate a un tag di criteri specifico dal servizio Proxy automatico WinHTTP.

Syntax

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

Parameters

hSession [in]

Handle di sessione WinHTTP valido creato da WinHttpOpen. L'handle deve essere un handle a livello di sessione.

PolicyEntryTag [in]

Identifica il set di voci di criteri da rimuovere. Uno dei valori seguenti.

valore	Meaning
TAG_WINHTTP_CONNECTION_POLICY_TAG_DEFAULT (0)	Voci di criteri predefinite/senza tag.
TAG_WINHTTP_CONNECTION_POLICY_TAG_CONNECTION_MANAGER (1)	Voci gestite dalla gestione connessione di sistema.
TAG_WINHTTP_CONNECTION_POLICY_TAG_WWWPT (2)	Voci gestite dal componente WWWPT (Windows Web Platform Transport).

Valore restituito

Restituisce ERROR_SUCCESS (0) in caso di esito positivo. Restituisce un codice di errore di sistema in caso di errore, incluso quanto segue.

valore	Description
ERROR_WINHTTP_INCORRECT_HANDLE_TYPE	hSession non è un handle di sessione.
ERROR_WINHTTP_NOT_INITIALIZED	Le globali WinHTTP non vengono inizializzate.
ERROR_ACCESS_DENIED	Il chiamante non dispone dei privilegi necessari.

Remarks

Annotazioni

Questa API non è attualmente inclusa in un file di intestazione SDK. È necessario dichiarare manualmente la funzione nel codice.

Rimuove tutte le voci dei criteri registrate in precedenza con il tag specificato. Le voci di altri tag rimangono invariate.

In genere chiamato prima di WinHttpConnectionSetPolicyEntries per garantire uno slate pulito durante l'aggiornamento dei criteri dal componente proprietario.

Questa API richiede privilegi elevati (administrator/SYSTEM).

Requisiti

Requirement	valore
Intestazione	N/A
Libreria	winhttp.lib
DLL	winhttp.dll

Vedere anche

• WinHttpConnectionSetPolicyEntries
• WinHttpOpen