명명된 네트워크 연결에 대한 프록시 구성을 포함합니다. 구조체는 공용 구조체를 사용하여 수동 프록시 구성과 자동(PAC 스크립트/WPAD) 구성을 모두 지원합니다.
Syntax
typedef struct _WINHTTP_CONNECTION_PROXY_INFO {
DWORD Version;
WCHAR *pwszFriendlyName;
DWORD Flags;
WINHTTP_CONNECTION_PROXY_INFO_SWITCH Switch;
union {
struct {
WCHAR *pwszServer;
WCHAR *pwszUsername;
WCHAR *pwszPassword;
WCHAR *pwszException;
WCHAR *pwszExtraInfo;
WORD Port;
} Config;
struct {
WCHAR *pwszScript;
WCHAR *pwszUsername;
WCHAR *pwszPassword;
} Script;
};
} WINHTTP_CONNECTION_PROXY_INFO;
구성원
버전
구조 버전입니다. WINHTTP_CONNECTION_PROXY_INFO_CURRENT_VERSION(1)로 설정해야 합니다.
pwszFriendlyName
프록시 구성 항목의 고유한 표시 이름입니다. NULL 또는 빈 문자열로 설정하면 고유한 이름이 자동으로 생성됩니다.
최대 길이: WINHTTP_CONNECTION_PROXY_INFO_FRIENDLY_NAME_MAX_LENGTH (64자).
플래그
다음 플래그의 조합입니다.
| Flag | 가치 | 설명 |
|---|---|---|
| WINHTTP_CONNECTION_PROXY_INFO_FLAG_DISABLED | 0x1 | 프록시 항목을 사용할 수 없습니다. |
| WINHTTP_CONNECTION_PROXY_INFO_FLAG_BYPASSLOCAL | 0x2 | 로컬 주소에 대한 프록시를 바이패스합니다. |
스위치
활성 상태인 공용 구조체 멤버를 결정하는 WINHTTP_CONNECTION_PROXY_INFO_SWITCH 값입니다.
설정
스위치가 WINHTTP_CONNECTION_PROXY_INFO_SWITCH_CONFIG 때 사용됩니다. 수동 프록시 구성을 포함합니다.
| 회원 | 설명 |
|---|---|
| pwszServer | 프록시 서버 주소입니다. 최대 길이: WINHTTP_CONNECTION_PROXY_INFO_SERVER_MAX_LENGTH (256자). |
| pwszUsername | 인증 사용자 이름입니다. 최대 길이: WINHTTP_CONNECTION_PROXY_INFO_USERNAME_MAX_LENGTH (128자). |
| pwszPassword | 인증 암호입니다. 최대 길이: WINHTTP_CONNECTION_PROXY_INFO_PASSWORD_MAX_LENGTH (128자). |
| pwszException | 바이패스/예외 목록입니다. 최대 길이: WINHTTP_CONNECTION_PROXY_INFO_EXCEPTION_MAX_LENGTH (1024자). |
| pwszExtraInfo | 추가 공급자 관련 정보입니다. 최대 길이: WINHTTP_CONNECTION_PROXY_INFO_EXTRA_INFO_MAX_LENGTH (1024자). |
| 항구 | 프록시 포트 번호입니다. |
스크립트
스위치가 WINHTTP_CONNECTION_PROXY_INFO_SWITCH_SCRIPT 또는 WINHTTP_CONNECTION_PROXY_INFO_SWITCH_WPAD 때 사용됩니다. 자동 프록시 구성을 포함합니다.
| 회원 | 설명 |
|---|---|
| pwszScript | PAC 스크립트 URL 또는 WPAD URL입니다. |
| pwszUsername | 인증 사용자 이름입니다. |
| pwszPassword | 인증 암호입니다. |
Remarks
메모
이 형식은 현재 SDK 헤더 파일에 포함되지 않습니다. 코드에서 직접 선언해야 합니다.
요구 사항
| Requirement | 가치 |
|---|---|
| Header | N/A |