다음을 통해 공유


API 플래그

대부분의 WinINet 함수는 플래그 배열을 매개 변수로 허용합니다. 다음은 정의된 플래그에 대한 간략한 설명입니다.

INTERNET_COOKIE_EVALUATE_P3P

0x80

P3P(Platform for Privacy Protection) 헤더를 쿠키와 연결해야 했음을 나타냅니다.

INTERNET_COOKIE_THIRD_PARTY

0x10

타사 쿠키가 설정되거나 검색되고 있음을 나타냅니다.

INTERNET_FLAG_ASYNC

0x10000000

이 함수에서 반환된 핸들에서 내림차순 핸들에 대한 비동기 요청만 수행합니다. InternetOpen 함수만 이 플래그를 사용합니다.

INTERNET_FLAG_CACHE_ASYNC

0x00000080

지연 캐시 쓰기를 허용합니다.

INTERNET_FLAG_CACHE_IF_NET_FAIL

0x00010000

ERROR_INTERNET_CONNECTION_RESET 또는ERROR_INTERNET_CANNOT_CONNECT 오류로 인해 리소스에 대한 네트워크 요청이 실패하면 캐시에서 리소스를 반환합니다. 이 플래그는 HttpOpenRequest에서 사용됩니다.

INTERNET_FLAG_DONT_CACHE

0x04000000

반환된 엔터티를 캐시에 추가하지 않습니다. 이는 기본 설정 값인 INTERNET_FLAG_NO_CACHE_WRITE 동일합니다.

INTERNET_FLAG_EXISTING_CONNECT

0x20000000

요청을 만드는 데 필요한 특성이 동일한 경우 기존 InternetConnect 개체를 사용하려고 시도합니다. FTP는 일반적으로 동일한 세션 동안 여러 작업을 수행하는 유일한 프로토콜이므로 FTP 작업에만 유용합니다. WinINet은 InternetOpen에서 생성된 각 HINTERNET 핸들에 대해 단일 연결 핸들을 캐시합니다. InternetOpenUrlInternetConnect 함수는 Http 및 Ftp 연결에 이 플래그를 사용합니다.

INTERNET_FLAG_FORMS_SUBMIT

0x00000040

양식 제출임을 나타냅니다.

INTERNET_FLAG_FROM_CACHE

0x01000000

네트워크 요청을 수행하지 않습니다. 모든 엔터티는 캐시에서 반환됩니다. 요청된 항목이 캐시에 없으면 ERROR_FILE_NOT_FOUND 같은 적절한 오류가 반환됩니다. InternetOpen 함수만 이 플래그를 사용합니다.

INTERNET_FLAG_FWD_BACK

0x00000020

함수가 현재 인터넷 캐시에 있는 리소스의 복사본을 사용해야 했음을 나타냅니다. 만료 날짜 및 리소스에 대한 기타 정보는 확인되지 않습니다. 요청된 항목이 인터넷 캐시에 없으면 시스템에서 네트워크에서 리소스를 찾으려고 시도합니다. 이 값은 Microsoft Internet Explorer 5에서 도입되었으며 인터넷 Explorer 앞으로뒤로 단추 작업과 연결됩니다.

INTERNET_FLAG_HYPERLINK

0x00000400

네트워크에서 항목을 다시 로드할지 여부를 결정할 때 만료 시간이 없고 서버에서 반환된 LastModified 시간이 없으면 강제로 다시 로드합니다. 이 플래그는 FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequestInternetOpenUrl에서 사용할 수 있습니다.

Windows XP 및 Windows Server 2003 R2 이하:GopherFindFirstFileGopherOpenFile에서도 사용됩니다.

INTERNET_FLAG_IGNORE_CERT_CN_INVALID

0x00001000

요청에 지정된 호스트 이름에 대해 서버에서 반환되는 SSL/PCT 기반 인증서의 검사를 사용하지 않도록 설정합니다. WinINet은 일치하는 호스트 이름과 간단한 와일드카드 규칙을 비교하여 인증서에 대한 간단한 검사 사용합니다. 이 플래그는 HttpOpenRequestInternetOpenUrl (HTTP 요청의 경우)에서 사용할 수 있습니다.

INTERNET_FLAG_IGNORE_CERT_DATE_INVALID

0x00002000

적절한 유효 날짜에 대한 SSL/PCT 기반 인증서 검사를 사용하지 않도록 설정합니다. 이 플래그는 HttpOpenRequestInternetOpenUrl (HTTP 요청의 경우)에서 사용할 수 있습니다.

INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTP

0x00008000

이 특수한 유형의 리디렉션 검색을 사용하지 않도록 설정합니다. 이 플래그를 사용하는 경우 WinINet은 HTTPS에서 HTTP URL로의 리디렉션을 투명하게 허용합니다. 이 플래그는 HttpOpenRequestInternetOpenUrl (HTTP 요청의 경우)에서 사용할 수 있습니다.

INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTPS

0x00004000

이 특수한 유형의 리디렉션 검색을 사용하지 않도록 설정합니다. 이 플래그를 사용하는 경우 WinINet은 HTTP에서 HTTPS URL로의 리디렉션을 투명하게 허용합니다. 이 플래그는 HttpOpenRequestInternetOpenUrl (HTTP 요청의 경우)에서 사용할 수 있습니다.

INTERNET_FLAG_KEEP_CONNECTION

0x00400000

연결에 대해 keep-alive 의미 체계(사용 가능한 경우)를 사용합니다. 이 플래그는 HttpOpenRequestInternetOpenUrl (HTTP 요청의 경우)에서 사용됩니다. 이 플래그는 MSN(Microsoft Network), NTLM 및 기타 유형의 인증에 필요합니다.

INTERNET_FLAG_MAKE_PERSISTENT

0x02000000

더 이상 지원되지 않습니다.

INTERNET_FLAG_MUST_CACHE_REQUEST

0x00000010

기본 설정 값과 동일 하며 INTERNET_FLAG_NEED_FILE. 파일을 캐시할 수 없는 경우 임시 파일을 만듭니다. 이 플래그는 FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequestInternetOpenUrl에서 사용할 수 있습니다.

Windows XP 및 Windows Server 2003 R2 이하:GopherFindFirstFileGopherOpenFile에서도 사용됩니다.

INTERNET_FLAG_NEED_FILE

0x00000010

파일을 캐시할 수 없는 경우 임시 파일을 만듭니다. 이 플래그는 FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequestInternetOpenUrl에서 사용할 수 있습니다.

Windows XP 및 Windows Server 2003 R2 이하:GopherFindFirstFileGopherOpenFile에서도 사용됩니다.

INTERNET_FLAG_NO_AUTH

0x00040000

인증을 자동으로 시도하지 않습니다. 이 플래그는 HttpOpenRequestInternetOpenUrl (HTTP 요청의 경우)에서 사용할 수 있습니다.

INTERNET_FLAG_NO_AUTO_REDIRECT

0x00200000

HttpSendRequest에서 리디렉션을 자동으로 처리하지 않습니다. 이 플래그는 INTERNETOpenUrl 에서 HTTP 요청에 사용할 수도 있습니다.

INTERNET_FLAG_NO_CACHE_WRITE

0x04000000

반환된 엔터티를 캐시에 추가하지 않습니다. 이 플래그는 , HttpOpenRequestInternetOpenUrl에서 사용됩니다.

Windows XP 및 Windows Server 2003 R2 이하:GopherFindFirstFileGopherOpenFile에서도 사용됩니다.

INTERNET_FLAG_NO_COOKIES

0x00080000

요청에 쿠키 헤더를 자동으로 추가하지 않으며 반환된 쿠키를 쿠키 데이터베이스에 자동으로 추가하지 않습니다. 이 플래그는 HttpOpenRequestInternetOpenUrl (HTTP 요청의 경우)에서 사용할 수 있습니다.

INTERNET_FLAG_NO_UI

0x00000200

쿠키 대화 상자를 사용하지 않도록 설정합니다. 이 플래그는 HttpOpenRequestInternetOpenUrl (HTTP 요청만 해당)에서 사용할 수 있습니다.

INTERNET_FLAG_OFFLINE

0x01000000

INTERNET_FLAG_FROM_CACHE 동일합니다. 네트워크 요청을 수행하지 않습니다. 모든 엔터티는 캐시에서 반환됩니다. 요청된 항목이 캐시에 없으면 ERROR_FILE_NOT_FOUND 같은 적절한 오류가 반환됩니다. InternetOpen 함수만 이 플래그를 사용합니다.

INTERNET_FLAG_PASSIVE

0x08000000

수동 FTP 의미 체계를 사용합니다. InternetConnectInternetOpenUrl만 이 플래그를 사용합니다. InternetConnect 는 FTP 요청에 이 플래그를 사용하고 InternetOpenUrl은 FTP 파일 및 디렉터리에 이 플래그를 사용합니다.

INTERNET_FLAG_PRAGMA_NOCACHE

0x00000100

캐시된 복사본이 프록시에 있더라도 원본 서버에서 요청을 강제로 확인합니다. InternetOpenUrl 함수(HTTP 및 HTTPS 요청에만 해당) 및 HttpOpenRequest 함수는 이 플래그를 사용합니다.

INTERNET_FLAG_RAW_DATA

0x40000000

FTP 디렉터리 정보를 검색할 때 데이터를 WIN32_FIND_DATA 구조로 반환합니다. 이 플래그를 지정하지 않았거나 CERN 프록시를 통해 호출이 수행되면 InternetOpenUrl 은 디렉터리의 HTML 버전을 반환합니다. InternetOpenUrl 함수만 이 플래그를 사용합니다.

Windows XP 및 Windows Server 2003 R2 이하: 또한 Gopher 디렉터리 정보를 검색할 때 GOPHER_FIND_DATA 구조를 반환합니다.

INTERNET_FLAG_READ_PREFETCH

0x00100000

이 플래그는 현재 사용할 수 없습니다.

INTERNET_FLAG_RELOAD

0x80000000

캐시가 아니라 원본 서버에서 요청한 파일, 개체 또는 디렉터리 목록을 다운로드합니다. FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequestInternetOpenUrl 함수는 이 플래그를 사용합니다.

Windows XP 및 Windows Server 2003 R2 이하:GopherFindFirstFileGopherOpenFile에서도 사용됩니다.

INTERNET_FLAG_RESTRICTED_ZONE

0x00020000

설정되는 쿠키가 신뢰할 수 없는 사이트와 연결되어 있음을 나타냅니다.

INTERNET_FLAG_RESYNCHRONIZE

0x00000800

리소스가 마지막으로 다운로드된 이후 수정된 경우 HTTP 리소스를 다시 로드합니다. 모든 FTP 리소스가 다시 로드됩니다. 이 플래그는 FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequestInternetOpenUrl에서 사용할 수 있습니다.

Windows XP 및 Windows Server 2003 R2 이하:GopherFindFirstFileGopherOpenFile에서도 사용되며 Gopher 리소스가 다시 로드됩니다.

INTERNET_FLAG_SECURE

0x00800000

보안 트랜잭션 의미 체계를 사용합니다. 이는 SSL/PCT(Secure Sockets Layer/Private Communications Technology)를 사용하는 것으로 변환되며 HTTP 요청에서만 의미가 있습니다. 이 플래그는 HttpOpenRequestInternetOpenUrl에서 사용되지만 URL에 https:// 표시되는 경우 중복됩니다. InternetConnect 함수는 HTTP 연결에 이 플래그를 사용합니다. 이 연결에서 만든 모든 요청 핸들은 이 플래그를 상속합니다.

INTERNET_FLAG_TRANSFER_ASCII

0x00000001

파일을 ASCII(FTP에만 해당)로 전송합니다. 이 플래그는 FtpOpenFile, FtpGetFileFtpPutFile에서 사용할 수 있습니다.

INTERNET_FLAG_TRANSFER_BINARY

0x00000002

파일을 이진 파일로 전송합니다(FTP만 해당). 이 플래그는 FtpOpenFile, FtpGetFileFtpPutFile에서 사용할 수 있습니다.

INTERNET_NO_CALLBACK

0x00000000

해당 API에 대해 콜백을 만들지 않음을 나타냅니다. 비동기 작업을 허용하는 함수의 dxContext 매개 변수에 사용됩니다.

INTERNET_OPTION_SUPPRESS_SERVER_AUTH

104

원본 서버에 로그온하지 않고 HTTP 프록시 서버에 자동 로그온을 수행하도록 HTTP 요청 개체를 설정합니다. 이 옵션은 프록시 서버와 원본 서버 모두에 대한 인증을 방지하는 요청 플래그 INTERNET_FLAG_NO_AUTH 다릅니다. 이 모드를 설정하면 원본 서버와 통신할 때 자격 증명 자료(이전에 제공된 사용자 이름/암호 또는 클라이언트 SSL 인증서)의 사용이 억제됩니다. 그러나 요청이 인증 프록시를 통해 전송되어야 하는 경우 WinINet은 사용자의 인트라넷 영역 설정에 따라 HTTP 프록시에 대한 자동 인증을 계속 수행합니다. 기본 인트라넷 영역 설정은 사용자의 기본 자격 증명을 사용하여 자동 로그온을 허용하는 것입니다. 모든 식별 정보를 표시하지 않도록 하기 위해 호출자는 INTERNET_OPTION_SUPPRESS_SERVER_AUTH INTERNET_FLAG_NO_COOKIES 요청 플래그와 결합해야 합니다. 이 옵션은 요청 개체가 전송되기 전에만 설정할 수 있습니다. 요청이 전송된 후 이 옵션을 설정하려고 하면 ERROR_INTERNET_INCORRECT_HANDLE_STATE 반환됩니다. 이 옵션에는 버퍼가 필요하지 않습니다. HttpOpenRequest에서 반환된 핸들에서만 InternetSetOption에서 사용됩니다. 버전: 인터넷 Explorer 8.0 이상이 필요합니다.

WININET_API_FLAG_ASYNC

0x00000001

비동기 작업을 강제로 수행합니다.

WININET_API_FLAG_SYNC

0x00000004

동기 작업을 강제로 수행합니다.

WININET_API_FLAG_USE_CONTEXT

0x00000008

API가 0으로 설정된 경우에도 컨텍스트 값을 강제로 사용합니다.

설명

참고

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

요구 사항

요구 사항
지원되는 최소 클라이언트
Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버
Windows 2000 Server[데스크톱 앱만]
헤더
Wininet.h