WinHTTP 자동 프록시 서비스에서 특정 정책 태그와 연결된 모든 연결 라우팅 정책 항목을 제거합니다.
Syntax
DWORD WINAPI WinHttpConnectionDeletePolicyEntries(
_In_ HINTERNET hSession,
_In_ WINHTTP_CONNECTION_POLICY_TAG PolicyEntryTag
);
매개 변수
hSession [in]
WinHttpOpen에서 만든 유효한 WinHTTP 세션 핸들입니다. 핸들은 세션 수준 핸들이어야 합니다.
PolicyEntryTag [in]
제거할 정책 항목 집합을 식별합니다. 다음 값 중 하나입니다.
| 가치 | Meaning |
|---|---|
| TAG_WINHTTP_CONNECTION_POLICY_TAG_DEFAULT (0) | 기본/태그가 지정되지 않은 정책 항목입니다. |
| TAG_WINHTTP_CONNECTION_POLICY_TAG_CONNECTION_MANAGER (1) | 시스템 연결 관리자가 관리하는 항목입니다. |
| TAG_WINHTTP_CONNECTION_POLICY_TAG_WWWPT (2) | WWWPT(Windows 웹 플랫폼 전송) 구성 요소에서 관리하는 항목입니다. |
반환 값
성공하면 ERROR_SUCCESS (0)를 반환합니다. 다음을 포함하여 오류에 대한 시스템 오류 코드를 반환합니다.
| 가치 | 설명 |
|---|---|
| ERROR_WINHTTP_INCORRECT_HANDLE_TYPE | hSession 은 세션 핸들이 아닙니다. |
| ERROR_WINHTTP_NOT_INITIALIZED | WinHTTP 전역은 초기화되지 않습니다. |
| ERROR_ACCESS_DENIED | 호출자에게 필요한 권한이 없습니다. |
Remarks
메모
이 API는 현재 SDK 헤더 파일에 포함되지 않습니다. 코드에서 함수를 직접 선언해야 합니다.
이전에 지정된 태그로 등록된 모든 정책 항목을 제거합니다. 다른 태그의 항목은 영향을 받지 않습니다.
일반적으로 소유 구성 요소에서 정책을 새로 고치는 경우 깨끗한 슬레이트를 보장하기 위해 WinHttpConnectionSetPolicyEntries 전에 호출됩니다.
이 API에는 관리자 권한(관리자/시스템) 권한이 필요합니다.
요구 사항
| Requirement | 가치 |
|---|---|
| Header | N/A |
| 라이브러리 | winhttp.lib |
| 동적 링크 라이브러리 (DLL) | winhttp.dll |