HTTP_DATA_CHUNK 구조체(http.h)

HTTP_DATA_CHUNK 구조는 메모리, 파일 또는 HTTP Server API 응답 조각 캐시의 개별 데이터 블록을 나타냅니다.

구문

typedef struct _HTTP_DATA_CHUNK {
  HTTP_DATA_CHUNK_TYPE DataChunkType;
  union {
    struct {
      PVOID pBuffer;
      ULONG BufferLength;
    } FromMemory;
    struct {
      HTTP_BYTE_RANGE ByteRange;
      HANDLE          FileHandle;
    } FromFileHandle;
    struct {
      USHORT FragmentNameLength;
      PCWSTR pFragmentName;
    } FromFragmentCache;
    struct {
      HTTP_BYTE_RANGE ByteRange;
      PCWSTR          pFragmentName;
    } FromFragmentCacheEx;
    struct {
      USHORT               TrailerCount;
      PHTTP_UNKNOWN_HEADER pTrailers;
    } Trailers;
    struct {
      HTTP_WINHTTP_FAST_FORWARDING_DATA WhFastForwardingData;
    } FromWinHttpFastForwarding;
  };
} HTTP_DATA_CHUNK, *PHTTP_DATA_CHUNK;

멤버

DataChunkType

데이터 저장소의 형식입니다. 이 멤버는 HTTP_DATA_CHUNK_TYPE 열거형의 값 중 하나일 수 있습니다.

FromMemory

FromMemory.pBuffer

데이터 블록의 시작 메모리 주소에 대한 포인터입니다.

FromMemory.BufferLength

데이터 블록의 길이(바이트)입니다.

FromFileHandle

FromFileHandle.ByteRange

파일의 전부 또는 일부를 지정하는 HTTP_BYTE_RANGE 구조체입니다. 전체 파일을 지정하려면 StartingOffset 멤버를 0으로 설정하고 Length 멤버를 HTTP_BYTE_RANGE_TO_EOF.

FromFileHandle.FileHandle

해당 파일에 대한 핸들을 엽니다.

FromFragmentCache

FromFragmentCache.FragmentNameLength

종료 null 문자를 포함하지 않는 조각 이름의 길이(바이트)입니다.

FromFragmentCache.pFragmentName

HttpAddFragmentToCache 함수를 사용하여 조각이 응답 조각 캐시에 추가되었을 때 할당된 조각 이름을 포함하는 문자열에 대한 포인터입니다.

FromFragmentCacheEx

FromFragmentCacheEx.ByteRange

캐시된 조각에서 바이트 범위를 지정하는 HTTP_BYTE_RANGE 구조체입니다.

FromFragmentCacheEx.pFragmentName

HttpAddFragmentToCache 함수를 사용하여 조각이 응답 조각 캐시에 추가되었을 때 할당된 조각 이름을 포함하는 문자열에 대한 포인터입니다. 문자열의 길이는 65532바이트를 초과할 수 없습니다.

참고 이 문자열은 NULL 종료되어야 합니다.

 

Trailers

Trailers.TrailerCount

pTrailers가 가리키는 배열의 HTTP_UNKNOWN_HEADER 구조체 수입니다.

Trailers.pTrailers

트레일러를 포함하는 HTTP_UNKNOWN_HEADER 구조체의 배열에 대한 포인터입니다.

FromWinHttpFastForwarding

FromWinHttpFastForwarding.WhFastForwardingData

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista, WINDOWS XP SP2 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
머리글	http.h

추가 정보

HTTP 서버 API 버전 1.0 구조체

HTTP_REQUEST

HTTP_RESPONSE

HttpAddFragmentToCache

HttpSendResponseEntityBody