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

다음 목록에는 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