struktur HTTP_RESPONSE_V1 (http.h)

Artikel
08/24/2023

Struktur HTTP_RESPONSE_V1 berisi data yang terkait dengan respons HTTP.

Jangan gunakan HTTP_RESPONSE_V1 langsung dalam kode Anda; gunakan HTTP_RESPONSE sebagai gantinya untuk memastikan bahwa versi yang tepat, berdasarkan sistem operasi yang kodenya dikompilasi di bawah, digunakan.

Sintaks

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;

Anggota

Flags

Bendera pengelogan opsional mengubah perilaku respons default. Ini bisa menjadi salah satu nilai HTTP_RESPONSE_FLAG .

Version

Anggota ini diabaikan; respons selalu merupakan respons HTTP/1.1.

StatusCode

Kode status numerik yang menandakan hasil permintaan HTTP (misalnya, 200 menandakan "OK" atau 404 menandakan "Tidak Ditemukan"). Untuk informasi selengkapnya dan daftar kode ini, lihat Bagian 10 RFC 2616.

Jika permintaan diarahkan ke URL yang dicadangkan tetapi tidak terdaftar, menunjukkan bahwa aplikasi yang sesuai untuk menanganinya tidak berjalan, maka API Server HTTP itu sendiri mengembalikan respons dengan kode status 400, menandakan "Permintaan Buruk". Ini transparan untuk aplikasi. Kode 400 lebih disukai di sini untuk 503 ("Server tidak tersedia") karena yang terakhir ditafsirkan oleh beberapa penyeimbang beban pintar sebagai indikasi bahwa server kelebihan beban.

ReasonLength

Ukuran, dalam byte, dari string yang diacu oleh anggota pReason tidak termasuk null yang mengakhiri. Mungkin nol.

pReason

Penunjuk ke string karakter cetak yang dapat dibaca manusia dan dihentikan null yang mencirikan hasil permintaan HTTP (misalnya, "OK" atau "Tidak Ditemukan").

Headers

Struktur HTTP_RESPONSE_HEADERS yang berisi header yang digunakan dalam respons ini.

EntityChunkCount

Sejumlah blok data badan entitas yang ditentukan dalam array pEntityChunks . Jumlah ini tidak boleh melebihi 100. Jika respons tidak memiliki badan entitas, anggota ini harus nol.

pEntityChunks

Array struktur HTTP_DATA_CHUNK yang bersama-sama menentukan semua blok data yang membentuk badan entitas respons.

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	http.h