structure HTTP_RESPONSE_V1 (http.h)
La structure HTTP_RESPONSE_V1 contient des données associées à une réponse HTTP.
N’utilisez pas HTTP_RESPONSE_V1 directement dans votre code ; utilisez HTTP_RESPONSE à la place pour vous assurer que la version appropriée, basée sur le système d’exploitation sous lequel le code est compilé, est utilisée.
Syntaxe
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;
Membres
Flags
Les indicateurs de journalisation facultatifs modifient le comportement de réponse par défaut. Il peut s’agir de l’une des valeurs HTTP_RESPONSE_FLAG .
Version
Ce membre est ignoré ; la réponse est toujours une réponse HTTP/1.1.
StatusCode
Numérique status code qui caractérise le résultat de la requête HTTP (par exemple, 200 signifiant « OK » ou 404 signifiant « Introuvable »). Pour plus d’informations et une liste de ces codes, consultez la section 10 de la RFC 2616.
Si une requête est dirigée vers une URL réservée mais non inscrite, indiquant que l’application appropriée pour la gérer n’est pas en cours d’exécution, l’API serveur HTTP elle-même retourne une réponse avec status code 400, ce qui signifie « Requête incorrecte ». Cela est transparent pour l’application. Un code 400 est préféré ici à 503 (« Serveur non disponible »), car ce dernier est interprété par certains équilibreurs de charge intelligents comme une indication que le serveur est surchargé.
ReasonLength
Taille, en octets, de la chaîne pointée vers laquelle le membre pReason n’inclut pas la valeur null de fin. Peut être zéro.
pReason
Pointeur vers une chaîne de caractères imprimables avec fin null et lisible par l’utilisateur qui caractérise le résultat de la requête HTTP (par exemple, « OK » ou « Introuvable »).
Headers
Une structure HTTP_RESPONSE_HEADERS qui contient les en-têtes utilisés dans cette réponse.
EntityChunkCount
Nombre de blocs de données de corps d’entité spécifiés dans le tableau pEntityChunks . Ce nombre ne peut pas dépasser 100. Si la réponse n’a pas de corps d’entité, ce membre doit être égal à zéro.
pEntityChunks
Tableau de structures HTTP_DATA_CHUNK qui spécifient ensemble tous les blocs de données qui composent le corps d’entité de la réponse.
Spécifications
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| En-tête | http.h |