estrutura HTTP_DATA_CHUNK (http.h)

A estrutura HTTP_DATA_CHUNK representa um bloco individual de dados na memória, em um arquivo ou no cache de fragmento de resposta da API do Servidor HTTP.

Sintaxe

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;

Membros

DataChunkType

Tipo de armazenamento de dados. Esse membro pode ser um dos valores da enumeração HTTP_DATA_CHUNK_TYPE .

FromMemory

FromMemory.pBuffer

Ponteiro para o endereço de memória inicial do bloco de dados.

FromMemory.BufferLength

Comprimento, em bytes, do bloco de dados.

FromFileHandle

FromFileHandle.ByteRange

Uma estrutura HTTP_BYTE_RANGE que especifica todo ou parte do arquivo. Para especificar o arquivo inteiro, defina o membro StartingOffset como zero e o membro Lengthcomo HTTP_BYTE_RANGE_TO_EOF.

FromFileHandle.FileHandle

Abra o identificador para o arquivo em questão.

FromFragmentCache

FromFragmentCache.FragmentNameLength

Comprimento, em bytes, do nome do fragmento que não inclui o caractere nulo de terminação.

FromFragmentCache.pFragmentName

Ponteiro para uma cadeia de caracteres que contém o nome do fragmento atribuído quando o fragmento foi adicionado ao cache de fragmento de resposta usando a função HttpAddFragmentToCache .

FromFragmentCacheEx

FromFragmentCacheEx.ByteRange

Uma estrutura HTTP_BYTE_RANGE especificando o intervalo de bytes no fragmento armazenado em cache.

FromFragmentCacheEx.pFragmentName

Ponteiro para uma cadeia de caracteres que contém o nome do fragmento atribuído quando o fragmento foi adicionado ao cache de fragmento de resposta usando a função HttpAddFragmentToCache . O comprimento da cadeia de caracteres não pode exceder 65532 bytes.

Nota Essa cadeia de caracteres deve ser terminada em NULL.

 

Trailers

Trailers.TrailerCount

Contagem do número de estruturas HTTP_UNKNOWN_HEADER na matriz apontada por pTrailers.

Trailers.pTrailers

Ponteiro para uma matriz de estruturas de HTTP_UNKNOWN_HEADER que contém os trailers.

FromWinHttpFastForwarding

FromWinHttpFastForwarding.WhFastForwardingData

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	http.h

Confira também

Estruturas da API do servidor HTTP versão 1.0

HTTP_REQUEST

HTTP_RESPONSE

HttpAddFragmentToCache

HttpSendResponseEntityBody