HTTP_RESPONSE_V1 구조체(http.h)

아티클
08/24/2023

HTTP_RESPONSE_V1 구조에는 HTTP 응답과 연결된 데이터가 포함됩니다.

코드에서 직접 HTTP_RESPONSE_V1 사용하지 마세요. 대신 HTTP_RESPONSE 사용하여 코드가 컴파일된 운영 체제에 따라 적절한 버전이 사용되는지 확인합니다.

구문

typedef struct _HTTP_RESPONSE_V1 {
  ULONG                 Flags;
  HTTP_VERSION          Version;
  USHORT                StatusCode;
  USHORT                ReasonLength;
  PCSTR                 pReason;
  HTTP_RESPONSE_HEADERS Headers;
  USHORT                EntityChunkCount;
  PHTTP_DATA_CHUNK      pEntityChunks;
} HTTP_RESPONSE_V1, *PHTTP_RESPONSE_V1;

멤버

Flags

선택적 로깅 플래그는 기본 응답 동작을 변경합니다. 이러한 값은 HTTP_RESPONSE_FLAG 값 중 하나일 수 있습니다.

Version

이 멤버는 무시됩니다. 응답은 항상 HTTP/1.1 응답입니다.

StatusCode

HTTP 요청의 결과를 나타내는 숫자 상태 코드입니다(예: "확인"을 나타내는 200 또는 "찾을 수 없음"을 나타내는 404). 자세한 내용과 이러한 코드 목록은 RFC 2616 섹션 10을 참조하세요.

요청이 예약되었지만 등록되지 않은 URL로 전달되어 처리할 적절한 애플리케이션이 실행되고 있지 않음을 나타내는 경우 HTTP Server API 자체는 "잘못된 요청"을 나타내는 상태 코드 400으로 응답을 반환합니다. 이는 애플리케이션에 투명합니다. 코드 400은 여기서 503("서버를 사용할 수 없음")으로 선호됩니다. 후자는 일부 스마트 부하 분산 장치에서 서버가 오버로드되었음을 나타내는 것으로 해석되기 때문입니다.

ReasonLength

종료 null을 포함하지 않는 pReason 멤버가 가리키는 문자열의 크기(바이트)입니다. 0일 수 있습니다.

pReason

HTTP 요청의 결과(예: "확인" 또는 "찾을 수 없음")의 특징을 나타내는 인쇄 가능한 문자의 사람이 읽을 수 있는 null로 끝나는 문자열에 대한 포인터입니다.

Headers

이 응답에 사용되는 헤더를 포함하는 HTTP_RESPONSE_HEADERS 구조체입니다.

EntityChunkCount

pEntityChunks 배열에 지정된 여러 엔터티 본문 데이터 블록입니다. 이 숫자는 100을 초과할 수 없습니다. 응답에 엔터티 본문이 없는 경우 이 멤버는 0이어야 합니다.

pEntityChunks

응답의 엔터티 본문을 구성하는 모든 데이터 블록을 함께 지정하는 HTTP_DATA_CHUNK 구조체의 배열입니다.

요구 사항


지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
머리글	http.h