INTERNET_PER_CONN_OPTIONW 구조체(wininet.h)

아티클
08/27/2023

옵션의 값을 포함합니다.

구문

typedef struct {
  DWORD dwOption;
  union {
    DWORD    dwValue;
    LPWSTR   pszValue;
    FILETIME ftValue;
  } Value;
} INTERNET_PER_CONN_OPTIONW, *LPINTERNET_PER_CONN_OPTIONW;

멤버

dwOption

쿼리하거나 설정할 옵션입니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

값	의미
INTERNET_PER_CONN_AUTOCONFIG_URL	URL이 포함된 문자열을 자동 구성 스크립트로 설정하거나 검색합니다.
INTERNET_PER_CONN_AUTODISCOVERY_FLAGS	자동 검색 설정을 설정하거나 검색합니다. Value 멤버에는 다음 값 중 하나 이상이 포함됩니다. AUTO_PROXY_FLAG_ALWAYS_DETECT 항상 자동으로 설정을 검색합니다. AUTO_PROXY_FLAG_CACHE_INIT_RUN 캐시된 파일이 만료되지 않는 한 실제로 스크립트를 실행하는 대신 자동 프록시 구성 스크립트의 캐시된 결과를 사용해야 했음을 나타냅니다. AUTO_PROXY_FLAG_DETECTION_RUN 이 연결에서 자동 검색이 한 번 이상 실행되었습니다. AUTO_PROXY_FLAG_DETECTION_SUSPECT 현재 지원되지 않습니다. AUTO_PROXY_FLAG_DONT_CACHE_PROXY_RESULT 자동 프록시 구성 스크립트의 결과 캐싱을 허용하지 않습니다. AUTO_PROXY_FLAG_MIGRATED 설정은 Microsoft 인터넷 Explorer 4.0 설치에서 마이그레이션되었으며 자동 검색을 한 번 시도해야 합니다. AUTO_PROXY_FLAG_USER_SET 사용자가 자동 검색을 명시적으로 설정했습니다.
INTERNET_PER_CONN_FLAGS	연결 형식을 설정하거나 검색합니다. Value 멤버에는 다음 값 중 하나 이상이 포함됩니다. PROXY_TYPE_DIRECT 연결에서 프록시 서버를 사용하지 않습니다. PROXY_TYPE_PROXY 연결은 명시적으로 설정된 프록시 서버를 사용합니다. PROXY_TYPE_AUTO_PROXY_URL 연결은 지정된 URL에서 자동 구성 스크립트를 다운로드하고 처리합니다. PROXY_TYPE_AUTO_DETECT 연결은 설정을 자동으로 검색합니다.
INTERNET_PER_CONN_PROXY_BYPASS	프록시 서버를 사용하지 않는 URL이 포함된 문자열을 설정하거나 검색합니다.
INTERNET_PER_CONN_PROXY_SERVER	프록시 서버를 포함하는 문자열을 설정하거나 검색합니다.
INTERNET_PER_CONN_AUTOCONFIG_SECONDARY_URL	연결된 자동 구성 URL입니다. 기본 자동 구성 URL이 프록시 정보에 대한 두 번째 자동 구성 URL을 설정하는 INS 파일을 가리키는 경우에 사용됩니다.
INTERNET_PER_CONN_AUTOCONFIG_RELOAD_DELAY_MINS	자동 검색을 통해 자동 구성 URL을 자동으로 새로 고칠 때까지의 시간(분)입니다.
INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_TIME	읽기 전용 옵션입니다. 자동 검색을 사용하여 마지막으로 알려진 양수 자동 구성 URL을 찾은 시간을 반환합니다.
INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_URL	읽기 전용 옵션입니다. 자동 검색을 사용하여 마지막으로 알려진 양수 URL을 반환합니다.

Windows 7 이상:

인터넷 Explorer 8을 지원하는 클라이언트는 INTERNET_PER_CONN_FLAGS_UI 사용하여 연결 형식을 쿼리해야 합니다. 이 쿼리가 실패하면 시스템에서 이전 버전의 인터넷 Explorer 실행되고 클라이언트는 INTERNET_PER_CONN_FLAGS 사용하여 다시 쿼리해야 합니다.

인터넷 Explorer 버전에 관계없이 INTERNET_PER_CONN_FLAGS 사용하여 연결 유형을 복원합니다.

값	의미
INTERNET_PER_CONN_FLAGS_UI	연결 형식을 설정하거나 검색합니다. Value 멤버에는 다음 값 중 하나 이상이 포함됩니다. PROXY_TYPE_DIRECT 연결에서 프록시 서버를 사용하지 않습니다. PROXY_TYPE_PROXY 연결은 명시적으로 설정된 프록시 서버를 사용합니다. PROXY_TYPE_AUTO_PROXY_URL 연결은 지정된 URL에서 자동 구성 스크립트를 다운로드하고 처리합니다. PROXY_TYPE_AUTO_DETECT 연결은 설정을 자동으로 검색합니다.

값

의미

INTERNET_PER_CONN_FLAGS_UI

연결 형식을 설정하거나 검색합니다. Value 멤버에는 다음 값 중 하나 이상이 포함됩니다.

PROXY_TYPE_DIRECT: 연결에서 프록시 서버를 사용하지 않습니다.
PROXY_TYPE_PROXY: 연결은 명시적으로 설정된 프록시 서버를 사용합니다.
PROXY_TYPE_AUTO_PROXY_URL: 연결은 지정된 URL에서 자동 구성 스크립트를 다운로드하고 처리합니다.
PROXY_TYPE_AUTO_DETECT: 연결은 설정을 자동으로 검색합니다.

Value

옵션의 값을 포함하는 공용 구조체입니다. dwOption 값에 따라 다음 형식 중 하나일 수 있습니다.

dwValue

부호 없는 긴 정수 값입니다.

pszValue

문자열 값에 대한 포인터입니다.

ftValue

FILETIME 구조체입니다.

Value.dwValue

부호 없는 긴 정수 값입니다.

Value.pszValue

문자열 값에 대한 포인터입니다.

Value.ftValue

FILETIME 구조체입니다.

설명

인터넷 Explorer 5에서는 InternetQueryOption 및 InternetSetOption의 ANSI 버전만 INTERNET_PER_CONN_OPTION 구조에서 작동합니다. 유니코드 버전은 이후 버전의 인터넷 Explorer INTERNET_PER_CONN_OPTION 구조를 지원합니다.

문자열을 반환하는 쿼리의 경우 InternetQueryOption 은 구조체의 pszValue 멤버에 대한 메모리를 할당합니다. 호출하는 애플리케이션은 문자열 사용을 마쳤을 때 GlobalFree 함수를 사용하여 이 메모리를 해제해야 합니다.

참고 WinINet은 서버 구현을 지원하지 않습니다. 또한 서비스에서 사용하지 않아야 합니다. 서버 구현 또는 서비스의 경우 WinHTTP(Microsoft Windows HTTP 서비스)를 사용합니다.

참고

wininet.h 헤더는 INTERNET_PER_CONN_OPTION 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
머리글	wininet.h