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

HTTP_RESPONSE_HEADERS

構造体
サイズx64: 512 バイト / x86: 256 バイト

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

フィールド

フィールドサイズx64x86説明
UnknownHeaderCountWORD2+0+0pUnknownHeaders配列に含まれる未知ヘッダーの数(WORD)である。
pUnknownHeadersHTTP_UNKNOWN_HEADER*8/4+8+4既知でないヘッダーを表すHTTP_UNKNOWN_HEADER配列へのポインターである。
TrailerCountWORD2+16+8pTrailers配列に含まれるトレーラーヘッダーの数(WORD)である。
pTrailersHTTP_UNKNOWN_HEADER*8/4+24+12トレーラーヘッダーを表すHTTP_UNKNOWN_HEADER配列へのポインターである。
KnownHeadersHTTP_KNOWN_HEADER480/240+32+16既知ヘッダーをヘッダーID順に格納したHTTP_KNOWN_HEADER配列である。

各言語での定義

#include <windows.h>

// 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;
using System;
using System.Runtime.InteropServices;

[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;
}
Imports System.Runtime.InteropServices

<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
import ctypes
from ctypes import wintypes

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),
    ]
#[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],
}
import "golang.org/x/sys/windows"

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_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;
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,
};
type
  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]
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;
}

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_HEADERS サイズ: 256 バイト(x86)
dim st, 64    ; 4byte整数×64(構造体サイズ 256 / 4 切り上げ)
; UnknownHeaderCount : WORD (+0, 2byte)  wpoke st,0,値  /  値 = wpeek(st,0)
; pUnknownHeaders : HTTP_UNKNOWN_HEADER* (+4, 4byte)  varptr(st)+4 を基点に操作(4byte:入れ子/配列)
; TrailerCount : WORD (+8, 2byte)  wpoke st,8,値  /  値 = wpeek(st,8)
; pTrailers : HTTP_UNKNOWN_HEADER* (+12, 4byte)  varptr(st)+12 を基点に操作(4byte:入れ子/配列)
; KnownHeaders : HTTP_KNOWN_HEADER (+16, 240byte)  varptr(st)+16 を基点に操作(240byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; HTTP_RESPONSE_HEADERS サイズ: 512 バイト(x64)
dim st, 128    ; 4byte整数×128(構造体サイズ 512 / 4 切り上げ)
; UnknownHeaderCount : WORD (+0, 2byte)  wpoke st,0,値  /  値 = wpeek(st,0)
; pUnknownHeaders : HTTP_UNKNOWN_HEADER* (+8, 8byte)  varptr(st)+8 を基点に操作(8byte:入れ子/配列)
; TrailerCount : WORD (+16, 2byte)  wpoke st,16,値  /  値 = wpeek(st,16)
; pTrailers : HTTP_UNKNOWN_HEADER* (+24, 8byte)  varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; KnownHeaders : HTTP_KNOWN_HEADER (+32, 480byte)  varptr(st)+32 を基点に操作(480byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#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

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