estructura de HTTP_DATA_CHUNK (http.h)

La estructura HTTP_DATA_CHUNK representa un bloque individual de datos en memoria, en un archivo o en la caché de fragmentos de fragmentos de respuesta de la API de SERVIDOR HTTP.

Sintaxis

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;

Miembros

DataChunkType

Tipo de almacén de datos. Este miembro puede ser uno de los valores de la enumeración HTTP_DATA_CHUNK_TYPE .

FromMemory

FromMemory.pBuffer

Puntero a la dirección de memoria inicial del bloque de datos.

FromMemory.BufferLength

Longitud, en bytes, del bloque de datos.

FromFileHandle

FromFileHandle.ByteRange

Estructura HTTP_BYTE_RANGE que especifica todo o parte del archivo. Para especificar todo el archivo, establezca el miembro StartingOffset en cero y el miembro Lengthen HTTP_BYTE_RANGE_TO_EOF.

FromFileHandle.FileHandle

Abra el identificador del archivo en cuestión.

FromFragmentCache

FromFragmentCache.FragmentNameLength

Longitud, en bytes, del nombre del fragmento que no incluye el carácter nulo de terminación.

FromFragmentCache.pFragmentName

Puntero a una cadena que contiene el nombre del fragmento asignado cuando se agregó el fragmento a la memoria caché de fragmentos de respuesta mediante la función HttpAddFragmentToCache .

FromFragmentCacheEx

FromFragmentCacheEx.ByteRange

Estructura HTTP_BYTE_RANGE que especifica el intervalo de bytes en el fragmento almacenado en caché.

FromFragmentCacheEx.pFragmentName

Puntero a una cadena que contiene el nombre del fragmento asignado cuando se agregó el fragmento a la memoria caché de fragmentos de respuesta mediante la función HttpAddFragmentToCache . La longitud de la cadena no puede superar los 65532 bytes.

Nota Esta cadena debe terminarse en NULL.
 

Trailers

Trailers.TrailerCount

Recuento del número de estructuras de HTTP_UNKNOWN_HEADER de la matriz a las que apuntan los pTrailers.

Trailers.pTrailers

Puntero a una matriz de estructuras HTTP_UNKNOWN_HEADER que contienen los finalizadores.

FromWinHttpFastForwarding

FromWinHttpFastForwarding.WhFastForwardingData

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado http.h

Consulte también

Estructuras de la API de servidor HTTP versión 1.0

HTTP_REQUEST

HTTP_RESPONSE

HttpAddFragmentToCache

HttpSendResponseEntityBody