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

이러한 특성 및 한정자는 WinHttpQueryHeaders에서 사용됩니다.

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

WINHTTP_QUERY_ACCEPT

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

WINHTTP_QUERY_ACCEPT_CHARSET

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

WINHTTP_QUERY_ACCEPT_ENCODING

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

WINHTTP_QUERY_ACCEPT_LANGUAGE

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

WINHTTP_QUERY_ACCEPT_RANGES

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

WINHTTP_QUERY_AGE

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

WINHTTP_QUERY_ALLOW

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

WINHTTP_QUERY_AUTHENTICATION_INFO

Authentication-Info 헤더를 검색합니다.

WINHTTP_QUERY_AUTHORIZATION

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

WINHTTP_QUERY_CACHE_CONTROL

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

WINHTTP_QUERY_CONNECTION

특정 연결에 대해 지정된 옵션을 검색하며 추가 연결을 통해 프록시가 전달해서는 안 됩니다.

WINHTTP_QUERY_CONTENT_BASE

기본 URI(Uniform Resource Identifier)를 검색하여 엔터티 내의 상대 URL을 확인합니다.

WINHTTP_QUERY_CONTENT_DESCRIPTION

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

WINHTTP_QUERY_CONTENT_DISPOSITION

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

WINHTTP_QUERY_CONTENT_ENCODING

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

WINHTTP_QUERY_CONTENT_ID

콘텐츠 ID를 검색합니다.

WINHTTP_QUERY_CONTENT_LANGUAGE

콘텐츠가 작성된 언어를 검색합니다.

WINHTTP_QUERY_CONTENT_LENGTH

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

WINHTTP_QUERY_CONTENT_LOCATION

메시지에 묶인 엔터티의 리소스 위치를 검색합니다.

WINHTTP_QUERY_CONTENT_MD5

엔터티 본문에 대한 엔드 투 엔드 메시지 무결성 검사를 제공하기 위해 엔터티 본문의 MD5 다이제스트를 검색합니다. 자세한 내용은 RFC 1864를 참조하세요.

WINHTTP_QUERY_CONTENT_RANGE

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

WINHTTP_QUERY_CONTENT_TRANSFER_ENCODING

엔터티 본문에 적용할 수 있는 인코딩 변환을 검색합니다. 이미 적용되었거나, 적용해야 하거나, 선택적으로 적용할 수 있습니다.

WINHTTP_QUERY_CONTENT_TYPE

텍스트 또는 html과 같은 리소스의 콘텐츠 형식을 받습니다.

WINHTTP_QUERY_COOKIE

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

WINHTTP_QUERY_COST

지원되지 않습니다.

WINHTTP_QUERY_CUSTOM

WinHttpQueryHeaders가 pwszName 매개 변수에 지정된 헤더 이름을 검색하고 헤더 정보를 lpBuffer에 저장하도록 합니다. 애플리케이션은 WINHTTP_OPTION_RECEIVE_RESPONSE_TIMEOUT 사용하여 이 쿼리가 모든 헤더가 수신될 때까지 대기하는 최대 시간을 제한할 수 있습니다.

WINHTTP_QUERY_DATE

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

WINHTTP_QUERY_DERIVED_FROM

지원되지 않습니다.

WINHTTP_QUERY_ETAG

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

WINHTTP_QUERY_EXPECT

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

WINHTTP_QUERY_EXPIRES

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

WINHTTP_QUERY_FORWARDED

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

WINHTTP_QUERY_FROM

보낸 사람 헤더가 지정된 경우 요청 중인 사용자 에이전트 를 제어하는 사용자의 전자 메일 주소를 검색합니다.

WINHTTP_QUERY_HOST

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

WINHTTP_QUERY_IF_MATCH

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

WINHTTP_QUERY_IF_MODIFIED_SINCE

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

WINHTTP_QUERY_IF_NONE_MATCH

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

WINHTTP_QUERY_IF_RANGE

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

WINHTTP_QUERY_IF_UNMODIFIED_SINCE

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

WINHTTP_QUERY_LINK

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

WINHTTP_QUERY_LAST_MODIFIED

리소스가 마지막으로 수정된 날짜와 시간을 받습니다. 날짜와 시간은 서버에 의해 결정됩니다.

WINHTTP_QUERY_LOCATION

Location response-header에 사용되는 절대 URI를 검색합니다.

WINHTTP_QUERY_MAX

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

WINHTTP_QUERY_MAX_FORWARDS

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

WINHTTP_QUERY_MESSAGE_ID

지원되지 않습니다.

WINHTTP_QUERY_MIME_VERSION

메시지를 생성하는 데 사용된 MIME(다목적 인터넷 메일 확장) 프로토콜의 버전을 받습니다.

WINHTTP_QUERY_ORIG_URI

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

WINHTTP_QUERY_PRAGMA

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

WINHTTP_QUERY_PROXY_AUTHENTICATE

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

WINHTTP_QUERY_PROXY_AUTHORIZATION

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

WINHTTP_QUERY_PROXY_CONNECTION

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

WINHTTP_QUERY_PROXY_SUPPORT

Proxy-Support 헤더를 검색합니다.

WINHTTP_QUERY_PUBLIC

이 서버에서 사용할 수 있는 HTTP 동사를 받습니다.

WINHTTP_QUERY_RANGE

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

WINHTTP_QUERY_RAW_HEADERS

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

WINHTTP_QUERY_RAW_HEADERS_CRLF

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

WINHTTP_QUERY_REFERER

요청된 URI를 가져온 리소스의 URI를 받습니다.

WINHTTP_QUERY_REFRESH

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

WINHTTP_QUERY_REQUEST_METHOD

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

WINHTTP_QUERY_RETRY_AFTER

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

WINHTTP_QUERY_SERVER

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

WINHTTP_QUERY_SET_COOKIE

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

WINHTTP_QUERY_STATUS_CODE

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

WINHTTP_QUERY_STATUS_TEXT

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

WINHTTP_QUERY_TITLE

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

WINHTTP_QUERY_TRANSFER_ENCODING

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

WINHTTP_QUERY_UNLESS_MODIFIED_SINCE

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

WINHTTP_QUERY_UPGRADE

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

WINHTTP_QUERY_URI

Request-URI 리소스를 식별할 수 있는 URI의 일부 또는 전부를 받습니다.

WINHTTP_QUERY_USER_AGENT

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

WINHTTP_QUERY_VARY

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

WINHTTP_QUERY_VERSION

상태 줄에 있는 HTTP 버전을 검색합니다.

WINHTTP_QUERY_VIA

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

WINHTTP_QUERY_WARNING

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

WINHTTP_QUERY_WWW_AUTHENTICATE

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

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

WINHTTP_QUERY_FLAG_NUMBER

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

WINHTTP_QUERY_FLAG_REQUEST_HEADERS

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

WINHTTP_QUERY_FLAG_SYSTEMTIME

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

WINHTTP_QUERY_FLAG_TRAILERS

Windows 11 버전 21H2(10.0; 빌드 22000). 응답 트레일러를 쿼리합니다. 응답 트레일러를 쿼리하기 전에 0바이트 읽기를 반환할 때까지 WinHttpReadData 를 호출해야 합니다.

WINHTTP_QUERY_FLAG_WIRE_ENCODING

Windows 11 버전 21H2(10.0; 빌드 22000). 기본적으로 WinHttpQueryHeaders 는 쿼리된 헤더를 반환하기 전에 유니코드 변환을 수행합니다. 이 플래그가 설정되면 WinHttp는 이 변환을 수행하지 않고 호출자에게 헤더를 반환합니다.

요구 사항

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

추가 정보

• WinHTTP 버전