структура 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;

Members

Версия

Версия структуры. Необходимо задать значение 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, определяющее, какой член объединения активен.

Config

Используется при 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 URL-адрес скрипта PAC или URL-адрес WPAD.
pwszUsername Имя пользователя проверки подлинности.
pwszPassword Пароль проверки подлинности.

Remarks

Замечание

Этот тип в настоящее время не включен в файл заголовка пакета SDK. Его необходимо объявить в коде.

Требования

Requirement Ценность
Header N/A

См. также