WINHTTP_CONNECTION_PROXY_INFO 구조체

명명된 네트워크 연결에 대한 프록시 구성을 포함합니다. 구조체는 공용 구조체를 사용하여 수동 프록시 구성과 자동(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

참고하십시오