Win32 API 日本語リファレンス
ホーム › Networking.HttpServer › HTTP_RESPONSE_V1

HTTP_RESPONSE_V1

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 552 バイト / x86: 280 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールド型サイズx64x86説明
FlagsDWORD4+0+0応答に関するフラグである。
VersionHTTP_VERSION4+4+4応答のHTTPバージョンを示すHTTP_VERSIONである。
StatusCodeWORD2+8+8HTTP応答ステータスコード(200等・WORD)である。
ReasonLengthWORD2+10+10pReasonのバイト長(WORD)である。
pReasonLPSTR8/4+16+12ステータスに対応する理由句を示すANSI文字列ポインターである。
HeadersHTTP_RESPONSE_HEADERS512/256+24+16応答ヘッダー一式を示すHTTP_RESPONSE_HEADERSである。
EntityChunkCountWORD2+536+272pEntityChunks配列に含まれるエンティティチャンクの数(WORD)である。
pEntityChunksHTTP_DATA_CHUNK*8/4+544+276応答本文のエンティティチャンクHTTP_DATA_CHUNK配列へのポインターである。

各言語での定義

#include <windows.h>

// HTTP_VERSION  (x64 4 / x86 4 バイト)
typedef struct HTTP_VERSION {
    WORD MajorVersion;
    WORD MinorVersion;
} HTTP_VERSION;

// HTTP_KNOWN_HEADER  (x64 16 / x86 8 バイト)
typedef struct HTTP_KNOWN_HEADER {
    WORD RawValueLength;
    LPSTR pRawValue;
} HTTP_KNOWN_HEADER;

// HTTP_RESPONSE_HEADERS  (x64 512 / x86 256 バイト)
typedef struct HTTP_RESPONSE_HEADERS {
    WORD UnknownHeaderCount;
    HTTP_UNKNOWN_HEADER* pUnknownHeaders;
    WORD TrailerCount;
    HTTP_UNKNOWN_HEADER* pTrailers;
    HTTP_KNOWN_HEADER KnownHeaders[30];
} HTTP_RESPONSE_HEADERS;

// HTTP_RESPONSE_V1  (x64 552 / x86 280 バイト)
typedef struct HTTP_RESPONSE_V1 {
    DWORD Flags;
    HTTP_VERSION Version;
    WORD StatusCode;
    WORD ReasonLength;
    LPSTR pReason;
    HTTP_RESPONSE_HEADERS Headers;
    WORD EntityChunkCount;
    HTTP_DATA_CHUNK* pEntityChunks;
} HTTP_RESPONSE_V1;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct HTTP_VERSION
{
    public ushort MajorVersion;
    public ushort MinorVersion;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct HTTP_KNOWN_HEADER
{
    public ushort RawValueLength;
    public IntPtr pRawValue;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct HTTP_RESPONSE_HEADERS
{
    public ushort UnknownHeaderCount;
    public IntPtr pUnknownHeaders;
    public ushort TrailerCount;
    public IntPtr pTrailers;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 30)] public HTTP_KNOWN_HEADER[] KnownHeaders;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct HTTP_RESPONSE_V1
{
    public uint Flags;
    public HTTP_VERSION Version;
    public ushort StatusCode;
    public ushort ReasonLength;
    public IntPtr pReason;
    public HTTP_RESPONSE_HEADERS Headers;
    public ushort EntityChunkCount;
    public IntPtr pEntityChunks;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure HTTP_VERSION
    Public MajorVersion As UShort
    Public MinorVersion As UShort
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure HTTP_KNOWN_HEADER
    Public RawValueLength As UShort
    Public pRawValue As IntPtr
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure HTTP_RESPONSE_HEADERS
    Public UnknownHeaderCount As UShort
    Public pUnknownHeaders As IntPtr
    Public TrailerCount As UShort
    Public pTrailers As IntPtr
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=30)> Public KnownHeaders() As HTTP_KNOWN_HEADER
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure HTTP_RESPONSE_V1
    Public Flags As UInteger
    Public Version As HTTP_VERSION
    Public StatusCode As UShort
    Public ReasonLength As UShort
    Public pReason As IntPtr
    Public Headers As HTTP_RESPONSE_HEADERS
    Public EntityChunkCount As UShort
    Public pEntityChunks As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class HTTP_VERSION(ctypes.Structure):
    _fields_ = [
        ("MajorVersion", ctypes.c_ushort),
        ("MinorVersion", ctypes.c_ushort),
    ]

class HTTP_KNOWN_HEADER(ctypes.Structure):
    _fields_ = [
        ("RawValueLength", ctypes.c_ushort),
        ("pRawValue", ctypes.c_void_p),
    ]

class HTTP_RESPONSE_HEADERS(ctypes.Structure):
    _fields_ = [
        ("UnknownHeaderCount", ctypes.c_ushort),
        ("pUnknownHeaders", ctypes.c_void_p),
        ("TrailerCount", ctypes.c_ushort),
        ("pTrailers", ctypes.c_void_p),
        ("KnownHeaders", HTTP_KNOWN_HEADER * 30),
    ]

class HTTP_RESPONSE_V1(ctypes.Structure):
    _fields_ = [
        ("Flags", wintypes.DWORD),
        ("Version", HTTP_VERSION),
        ("StatusCode", ctypes.c_ushort),
        ("ReasonLength", ctypes.c_ushort),
        ("pReason", ctypes.c_void_p),
        ("Headers", HTTP_RESPONSE_HEADERS),
        ("EntityChunkCount", ctypes.c_ushort),
        ("pEntityChunks", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct HTTP_VERSION {
    pub MajorVersion: u16,
    pub MinorVersion: u16,
}

#[repr(C)]
pub struct HTTP_KNOWN_HEADER {
    pub RawValueLength: u16,
    pub pRawValue: *mut core::ffi::c_void,
}

#[repr(C)]
pub struct HTTP_RESPONSE_HEADERS {
    pub UnknownHeaderCount: u16,
    pub pUnknownHeaders: *mut core::ffi::c_void,
    pub TrailerCount: u16,
    pub pTrailers: *mut core::ffi::c_void,
    pub KnownHeaders: [HTTP_KNOWN_HEADER; 30],
}

#[repr(C)]
pub struct HTTP_RESPONSE_V1 {
    pub Flags: u32,
    pub Version: HTTP_VERSION,
    pub StatusCode: u16,
    pub ReasonLength: u16,
    pub pReason: *mut core::ffi::c_void,
    pub Headers: HTTP_RESPONSE_HEADERS,
    pub EntityChunkCount: u16,
    pub pEntityChunks: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type HTTP_VERSION struct {
	MajorVersion uint16
	MinorVersion uint16
}

type HTTP_KNOWN_HEADER struct {
	RawValueLength uint16
	pRawValue uintptr
}

type HTTP_RESPONSE_HEADERS struct {
	UnknownHeaderCount uint16
	pUnknownHeaders uintptr
	TrailerCount uint16
	pTrailers uintptr
	KnownHeaders [30]HTTP_KNOWN_HEADER
}

type HTTP_RESPONSE_V1 struct {
	Flags uint32
	Version HTTP_VERSION
	StatusCode uint16
	ReasonLength uint16
	pReason uintptr
	Headers HTTP_RESPONSE_HEADERS
	EntityChunkCount uint16
	pEntityChunks uintptr
}
type
  HTTP_VERSION = record
    MajorVersion: Word;
    MinorVersion: Word;
  end;

  HTTP_KNOWN_HEADER = record
    RawValueLength: Word;
    pRawValue: Pointer;
  end;

  HTTP_RESPONSE_HEADERS = record
    UnknownHeaderCount: Word;
    pUnknownHeaders: Pointer;
    TrailerCount: Word;
    pTrailers: Pointer;
    KnownHeaders: array[0..29] of HTTP_KNOWN_HEADER;
  end;

  HTTP_RESPONSE_V1 = record
    Flags: DWORD;
    Version: HTTP_VERSION;
    StatusCode: Word;
    ReasonLength: Word;
    pReason: Pointer;
    Headers: HTTP_RESPONSE_HEADERS;
    EntityChunkCount: Word;
    pEntityChunks: Pointer;
  end;
const HTTP_VERSION = extern struct {
    MajorVersion: u16,
    MinorVersion: u16,
};

const HTTP_KNOWN_HEADER = extern struct {
    RawValueLength: u16,
    pRawValue: ?*anyopaque,
};

const HTTP_RESPONSE_HEADERS = extern struct {
    UnknownHeaderCount: u16,
    pUnknownHeaders: ?*anyopaque,
    TrailerCount: u16,
    pTrailers: ?*anyopaque,
    KnownHeaders: [30]HTTP_KNOWN_HEADER,
};

const HTTP_RESPONSE_V1 = extern struct {
    Flags: u32,
    Version: HTTP_VERSION,
    StatusCode: u16,
    ReasonLength: u16,
    pReason: ?*anyopaque,
    Headers: HTTP_RESPONSE_HEADERS,
    EntityChunkCount: u16,
    pEntityChunks: ?*anyopaque,
};
type
  HTTP_VERSION {.bycopy.} = object
    MajorVersion: uint16
    MinorVersion: uint16

  HTTP_KNOWN_HEADER {.bycopy.} = object
    RawValueLength: uint16
    pRawValue: pointer

  HTTP_RESPONSE_HEADERS {.bycopy.} = object
    UnknownHeaderCount: uint16
    pUnknownHeaders: pointer
    TrailerCount: uint16
    pTrailers: pointer
    KnownHeaders: array[30, HTTP_KNOWN_HEADER]

  HTTP_RESPONSE_V1 {.bycopy.} = object
    Flags: uint32
    Version: HTTP_VERSION
    StatusCode: uint16
    ReasonLength: uint16
    pReason: pointer
    Headers: HTTP_RESPONSE_HEADERS
    EntityChunkCount: uint16
    pEntityChunks: pointer
struct HTTP_VERSION
{
    ushort MajorVersion;
    ushort MinorVersion;
}

struct HTTP_KNOWN_HEADER
{
    ushort RawValueLength;
    void* pRawValue;
}

struct HTTP_RESPONSE_HEADERS
{
    ushort UnknownHeaderCount;
    void* pUnknownHeaders;
    ushort TrailerCount;
    void* pTrailers;
    HTTP_KNOWN_HEADER[30] KnownHeaders;
}

struct HTTP_RESPONSE_V1
{
    uint Flags;
    HTTP_VERSION Version;
    ushort StatusCode;
    ushort ReasonLength;
    void* pReason;
    HTTP_RESPONSE_HEADERS Headers;
    ushort EntityChunkCount;
    void* pEntityChunks;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; HTTP_RESPONSE_V1 サイズ: 280 バイト(x86)
dim st, 70    ; 4byte整数×70(構造体サイズ 280 / 4 切り上げ)
; Flags : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Version : HTTP_VERSION (+4, 4byte)  varptr(st)+4 を基点に操作(4byte:入れ子/配列)
; StatusCode : WORD (+8, 2byte)  wpoke st,8,値  /  値 = wpeek(st,8)
; ReasonLength : WORD (+10, 2byte)  wpoke st,10,値  /  値 = wpeek(st,10)
; pReason : LPSTR (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; Headers : HTTP_RESPONSE_HEADERS (+16, 256byte)  varptr(st)+16 を基点に操作(256byte:入れ子/配列)
; EntityChunkCount : WORD (+272, 2byte)  wpoke st,272,値  /  値 = wpeek(st,272)
; pEntityChunks : HTTP_DATA_CHUNK* (+276, 4byte)  varptr(st)+276 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; HTTP_RESPONSE_V1 サイズ: 552 バイト(x64)
dim st, 138    ; 4byte整数×138(構造体サイズ 552 / 4 切り上げ)
; Flags : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Version : HTTP_VERSION (+4, 4byte)  varptr(st)+4 を基点に操作(4byte:入れ子/配列)
; StatusCode : WORD (+8, 2byte)  wpoke st,8,値  /  値 = wpeek(st,8)
; ReasonLength : WORD (+10, 2byte)  wpoke st,10,値  /  値 = wpeek(st,10)
; pReason : LPSTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; Headers : HTTP_RESPONSE_HEADERS (+24, 512byte)  varptr(st)+24 を基点に操作(512byte:入れ子/配列)
; EntityChunkCount : WORD (+536, 2byte)  wpoke st,536,値  /  値 = wpeek(st,536)
; pEntityChunks : HTTP_DATA_CHUNK* (+544, 8byte)  varptr(st)+544 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global HTTP_VERSION
    #field short MajorVersion
    #field short MinorVersion
#endstruct

#defstruct global HTTP_KNOWN_HEADER
    #field short RawValueLength
    #field intptr pRawValue
#endstruct

#defstruct global HTTP_RESPONSE_HEADERS
    #field short UnknownHeaderCount
    #field intptr pUnknownHeaders
    #field short TrailerCount
    #field intptr pTrailers
    #field HTTP_KNOWN_HEADER KnownHeaders 30
#endstruct

#defstruct global HTTP_RESPONSE_V1
    #field int Flags
    #field HTTP_VERSION Version
    #field short StatusCode
    #field short ReasonLength
    #field intptr pReason
    #field HTTP_RESPONSE_HEADERS Headers
    #field short EntityChunkCount
    #field intptr pEntityChunks
#endstruct

stdim st, HTTP_RESPONSE_V1        ; NSTRUCT 変数を確保
st->Flags = 100
mes "Flags=" + st->Flags