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바이트를 초과할 수 없습니다.
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 |