쿼리 정보 플래그(Wininet.h)

아티클
06/13/2023

다음 목록에는 HttpQueryInfo 및 QueryInfo에서 사용하는 특성 및 한정자가 포함되어 있습니다.

특성 플래그는 HttpQueryInfo (또는 QueryInfo)에서 검색할 데이터를 나타내는 데 사용됩니다. 대부분의 특성 플래그는 특정 HTTP 헤더에 직접 매핑합니다. 특정 헤더와 관련이 없는 HTTP_QUERY_RAW_HEADERS 같은 몇 가지 특수 플래그도 있습니다.

HTTP_QUERY_ACCEPT

24
응답에 허용되는 미디어 형식을 검색합니다.

HTTP_QUERY_ACCEPT_CHARSET

25
응답에 허용되는 문자 집합을 검색합니다.

HTTP_QUERY_ACCEPT_ENCODING

26
응답에 허용되는 콘텐츠 코딩 값을 검색합니다.

HTTP_QUERY_ACCEPT_LANGUAGE

27
응답에 허용되는 자연어를 검색합니다.

HTTP_QUERY_ACCEPT_RANGES

42
리소스에 대해 허용되는 범위 요청 유형을 검색합니다.

HTTP_QUERY_AGE

48
원본 서버에서 응답이 생성된 이후 보낸 사람의 예상 시간을 포함하는 Age response-header 필드를 검색합니다.

HTTP_QUERY_ALLOW

7
서버에서 지원하는 HTTP 동사를 받습니다.

HTTP_QUERY_AUTHORIZATION

28
요청에 사용되는 권한 부여 자격 증명을 검색합니다.

HTTP_QUERY_CACHE_CONTROL

49
캐시 제어 지시문을 검색합니다.

HTTP_QUERY_CONNECTION

23
특정 연결에 대해 지정되고 추가 연결을 통해 프록시에서 전달해서는 안 되는 옵션을 검색합니다.

HTTP_QUERY_CONTENT_BASE

50
엔터티 내에서 상대 URL을 확인하기 위한 기본 URI(Uniform Resource Identifier)를 검색합니다.

HTTP_QUERY_CONTENT_DESCRIPTION

4
사용되지 않습니다. 레거시 애플리케이션 호환성을 위해서만 유지 관리됩니다.

HTTP_QUERY_CONTENT_DISPOSITION

47
사용되지 않습니다. 레거시 애플리케이션 호환성을 위해서만 유지 관리됩니다.

HTTP_QUERY_CONTENT_ENCODING

29
전체 리소스에 적용된 추가 콘텐츠 코딩을 검색합니다.

HTTP_QUERY_CONTENT_ID

3
콘텐츠 ID를 검색합니다.

HTTP_QUERY_CONTENT_LANGUAGE

6
콘텐츠가 있는 언어를 검색합니다.

HTTP_QUERY_CONTENT_LENGTH

5
리소스 크기를 바이트 단위로 검색합니다.

HTTP_QUERY_CONTENT_LOCATION

51
메시지에 포함된 엔터티의 리소스 위치를 검색합니다.

HTTP_QUERY_CONTENT_MD5

52
엔터티 본문에 대한 MIC(엔드 투 엔드 메시지 무결성 검사)를 제공하기 위해 엔터티 본문의 MD5 다이제스트를 검색합니다. 자세한 내용은 에서 RFC1864, Content-MD5 헤더 필드를 참조하세요 https://ftp.isi.edu/in-notes/rfc1864.txt.

HTTP_QUERY_CONTENT_RANGE

53
부분 엔터티 본문을 삽입해야 하는 전체 엔터티 본문의 위치와 전체 엔터티 본문의 총 크기를 검색합니다.

HTTP_QUERY_CONTENT_TRANSFER_ENCODING

2
리소스에 적용된 추가 콘텐츠 코딩을 받습니다.

HTTP_QUERY_CONTENT_TYPE

1
리소스의 콘텐츠 형식(예: text/html)을 받습니다.

HTTP_QUERY_COOKIE

44
요청과 연결된 쿠키를 검색합니다.

HTTP_QUERY_COST

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

HTTP_QUERY_CUSTOM

65535
HttpQueryInfo가 lpvBuffer에 지정된 헤더 이름을 검색하고 헤더 데이터를 lpvBuffer에 저장하도록 합니다.

HTTP_QUERY_DATE

9
메시지가 시작된 날짜와 시간을 받습니다.

HTTP_QUERY_DERIVED_FROM

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

HTTP_QUERY_ECHO_HEADERS

73
현재 구현되지 않습니다.

HTTP_QUERY_ECHO_HEADERS_CRLF

74
현재 구현되지 않습니다.

HTTP_QUERY_ECHO_REPLY

72
현재 구현되지 않습니다.

HTTP_QUERY_ECHO_REQUEST

71
현재 구현되지 않습니다.

HTTP_QUERY_ETAG

54
연결된 엔터티에 대한 엔터티 태그를 검색합니다.

HTTP_QUERY_EXPECT

68
클라이언트 애플리케이션에서 100 시리즈 응답을 예상해야 하는지 여부를 나타내는 Expect 헤더를 검색합니다.

HTTP_QUERY_EXPIRES

10
리소스가 오래된 것으로 간주되어야 하는 날짜 및 시간을 받습니다.

HTTP_QUERY_FORWARDED

30
사용되지 않습니다. 레거시 애플리케이션 호환성을 위해 유지 관리됩니다.

HTTP_QUERY_FROM

31
보낸 사람 헤더가 제공된 경우 요청하는 사용자 에이전트를 제어하는 사용자에 대한 이메일 주소를 검색합니다.

HTTP_QUERY_HOST

55
요청되는 리소스의 인터넷 호스트 및 포트 번호를 검색합니다.

HTTP_QUERY_IF_MATCH

56
If-Match 요청 헤더 필드의 내용을 검색합니다.

HTTP_QUERY_IF_MODIFIED_SINCE

32
If-Modified-Since 헤더의 내용을 검색합니다.

HTTP_QUERY_IF_NONE_MATCH

57
If-None-Match 요청 헤더 필드의 내용을 검색합니다.

HTTP_QUERY_IF_RANGE

58
If-Range 요청 헤더 필드의 내용을 검색합니다. 이 헤더를 사용하면 클라이언트 애플리케이션이 클라이언트 애플리케이션 캐시에 있는 엔터티의 부분 복사본과 관련된 엔터티가 업데이트되지 않은지 확인할 수 있습니다. 엔터티가 업데이트되지 않은 경우 클라이언트 애플리케이션이 누락된 파트를 보냅니다. 엔터티가 업데이트된 경우 업데이트된 전체 엔터티를 보냅니다.

HTTP_QUERY_IF_UNMODIFIED_SINCE

59
If-Unmodified-Since request-header 필드의 내용을 검색합니다.

HTTP_QUERY_LAST_MODIFIED

11
서버에서 리소스가 마지막으로 수정된 것으로 판단되는 날짜와 시간을 받습니다.

HTTP_QUERY_LINK

16
사용되지 않습니다. 레거시 애플리케이션 호환성을 위해 유지 관리됩니다.

HTTP_QUERY_LOCATION

33
위치 응답 헤더에 사용되는 절대 URI(Uniform Resource Identifier)를 검색합니다.

HTTP_QUERY_MAX

78
쿼리 플래그가 아닙니다. HTTP_QUERY_* 값의 최대값을 나타냅니다.

HTTP_QUERY_MAX_FORWARDS

60
다음 인바운드 서버로 요청을 전달할 수 있는 프록시 또는 게이트웨이 수를 검색합니다.

HTTP_QUERY_MESSAGE_ID

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

HTTP_QUERY_MIME_VERSION

0
메시지를 생성하는 데 사용된 MIME 프로토콜의 버전을 받습니다.

HTTP_QUERY_ORIG_URI

34
사용되지 않습니다. 레거시 애플리케이션 호환성을 위해 유지 관리됩니다.

HTTP_QUERY_PRAGMA

17
요청/응답 체인을 따라 받는 사람에게 적용할 수 있는 구현별 지시문을 받습니다.

HTTP_QUERY_PROXY_AUTHENTICATE

41
프록시에서 반환된 인증 체계 및 영역을 검색합니다.

HTTP_QUERY_PROXY_AUTHORIZATION

61
인증이 필요한 프록시에 사용자를 식별하는 데 사용되는 헤더를 검색합니다. 이 헤더는 요청이 서버로 전송되기 전에 검색할 수 있습니다.

HTTP_QUERY_PROXY_CONNECTION

69
Proxy-Connection 헤더를 검색합니다.

HTTP_QUERY_PUBLIC

8
이 서버에서 사용할 수 있는 메서드를 받습니다.

HTTP_QUERY_RANGE

62
엔터티의 바이트 범위를 검색합니다.

HTTP_QUERY_RAW_HEADERS

21
서버에서 반환된 모든 헤더를 수신합니다. 각 헤더는 "\0"으로 종료됩니다. 추가 "\0"은 헤더 목록을 종료합니다.

HTTP_QUERY_RAW_HEADERS_CRLF

22
서버에서 반환된 모든 헤더를 수신합니다. 각 헤더는 CR/LF(캐리지 리턴/줄 바꿈) 시퀀스로 구분됩니다.

HTTP_QUERY_REFERER

35
요청된 URI를 가져온 리소스의 URI(Uniform Resource Identifier)를 받습니다.

HTTP_QUERY_REFRESH

46
사용되지 않습니다. 레거시 애플리케이션 호환성을 위해서만 유지 관리됩니다.

HTTP_QUERY_REQUEST_METHOD

45
요청에 사용되는 HTTP 동사(일반적으로 GET 또는 POST)를 받습니다.

HTTP_QUERY_RETRY_AFTER

36
서비스를 사용할 수 없을 것으로 예상되는 시간을 검색합니다.

HTTP_QUERY_SERVER

37
원본 서버에서 요청을 처리하는 데 사용하는 소프트웨어에 대한 데이터를 검색합니다.

HTTP_QUERY_SET_COOKIE

43
요청에 대한 쿠키 집합의 값을 받습니다.

HTTP_QUERY_STATUS_CODE

19
서버에서 반환된 상태 코드를 받습니다. 자세한 내용과 가능한 값 목록은 HTTP 상태 코드를 참조하세요.

HTTP_QUERY_STATUS_TEXT

20
응답 줄에서 서버에서 반환된 추가 텍스트를 받습니다.

HTTP_QUERY_TITLE

38
사용되지 않습니다. 레거시 애플리케이션 호환성을 위해서만 유지 관리됩니다.

HTTP_QUERY_TRANSFER_ENCODING

63
보낸 사람과 받는 사람 간에 안전하게 전송할 수 있도록 메시지 본문에 적용된 변환 유형을 검색합니다.

HTTP_QUERY_UNLESS_MODIFIED_SINCE

70
Unless-Modified-Since 헤더를 검색합니다.

HTTP_QUERY_UPGRADE

64
서버에서 지원하는 추가 통신 프로토콜을 검색합니다.

HTTP_QUERY_URI

13
Request-URI 리소스를 식별할 수 있는 URI(Uniform Resource Identifier)의 일부 또는 전부를 받습니다.

HTTP_QUERY_USER_AGENT

39
요청을 수행한 사용자 에이전트에 대한 데이터를 검색합니다.

HTTP_QUERY_VARY

65
서버 기반 협상을 사용하여 응답의 사용 가능한 여러 표현에서 엔터티가 선택되었음을 나타내는 헤더를 검색합니다.

HTTP_QUERY_VERSION

18
서버에서 반환된 마지막 응답 코드를 받습니다.

HTTP_QUERY_VIA

66
요청에 따라 사용자 에이전트와 서버 간의 중간 프로토콜과 받는 사람을 검색하고, 응답에서 원본 서버와 클라이언트 간에 검색합니다.

HTTP_QUERY_WARNING

67
응답 상태 코드에 반영되지 않을 수 있는 응답의 상태 대한 추가 데이터를 검색합니다.

HTTP_QUERY_WWW_AUTHENTICATE

40
서버에서 반환하는 인증 체계 및 영역을 검색합니다.

HTTP_QUERY_X_CONTENT_TYPE_OPTIONS

79
X-Content-Type-Options 헤더 값을 검색합니다.

HTTP_QUERY_P3P

80
P3P 헤더 값을 검색합니다.

HTTP_QUERY_X_P2P_PEERDIST

81
X-P2P-PeerDist 헤더 값을 검색합니다.

HTTP_QUERY_TRANSLATE

82
변환 헤더 값을 검색합니다.

HTTP_QUERY_X_UA_COMPATIBLE

83
X-UA 호환 헤더 값을 검색합니다.

HTTP_QUERY_DEFAULT_STYLE

84
Default-Style 헤더 값을 검색합니다.

HTTP_QUERY_X_FRAME_OPTIONS

85
X-Frame-Options 헤더 값을 검색합니다.

HTTP_QUERY_X_XSS_PROTECTION

86
X-XSS-Protection 헤더 값을 검색합니다.

한정자 플래그는 특성을 플래그와 함께 사용하여 요청을 수정합니다. 한정자 플래그는 반환되는 데이터의 형식을 수정하거나 HttpQueryInfo (또는 QueryInfo)가 데이터를 검색할 위치를 나타냅니다.

HTTP_QUERY_FLAG_COALESCE

0x10000000
구현되지 않았습니다.

HTTP_QUERY_FLAG_NUMBER

0x20000000
값이 숫자(예: 상태 코드)인 헤더의 경우 데이터를 32비트 숫자로 반환합니다.

HTTP_QUERY_FLAG_REQUEST_HEADERS

0x80000000
쿼리는 헤더만 요청합니다.

HTTP_QUERY_FLAG_SYSTEMTIME

0x40000000
헤더 값을 SYSTEMTIME 구조체로 반환하며, 애플리케이션에서 데이터를 구문 분석할 필요가 없습니다. 값이 날짜/시간 문자열인 헤더(예: "마지막 수정 시간")에 사용합니다.

설명

참고

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

요구 사항

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

다음을 통해 공유

쿼리 정보 플래그(Wininet.h)

설명

요구 사항

피드백

추가 리소스