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

HTTP_REQUEST_HEADERS

構造体
サイズx64: 688 バイト / x86: 344 バイト

サイズ=各フィールドのバイト数(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_HEADER656/328+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_REQUEST_HEADERS  (x64 688 / x86 344 バイト)
typedef struct HTTP_REQUEST_HEADERS {
    WORD UnknownHeaderCount;
    HTTP_UNKNOWN_HEADER* pUnknownHeaders;
    WORD TrailerCount;
    HTTP_UNKNOWN_HEADER* pTrailers;
    HTTP_KNOWN_HEADER KnownHeaders[41];
} HTTP_REQUEST_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_REQUEST_HEADERS
{
    public ushort UnknownHeaderCount;
    public IntPtr pUnknownHeaders;
    public ushort TrailerCount;
    public IntPtr pTrailers;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 41)] 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_REQUEST_HEADERS
    Public UnknownHeaderCount As UShort
    Public pUnknownHeaders As IntPtr
    Public TrailerCount As UShort
    Public pTrailers As IntPtr
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=41)> 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_REQUEST_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 * 41),
    ]
#[repr(C)]
pub struct HTTP_KNOWN_HEADER {
    pub RawValueLength: u16,
    pub pRawValue: *mut core::ffi::c_void,
}

#[repr(C)]
pub struct HTTP_REQUEST_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; 41],
}
import "golang.org/x/sys/windows"

type HTTP_KNOWN_HEADER struct {
	RawValueLength uint16
	pRawValue uintptr
}

type HTTP_REQUEST_HEADERS struct {
	UnknownHeaderCount uint16
	pUnknownHeaders uintptr
	TrailerCount uint16
	pTrailers uintptr
	KnownHeaders [41]HTTP_KNOWN_HEADER
}
type
  HTTP_KNOWN_HEADER = record
    RawValueLength: Word;
    pRawValue: Pointer;
  end;

  HTTP_REQUEST_HEADERS = record
    UnknownHeaderCount: Word;
    pUnknownHeaders: Pointer;
    TrailerCount: Word;
    pTrailers: Pointer;
    KnownHeaders: array[0..40] of HTTP_KNOWN_HEADER;
  end;
const HTTP_KNOWN_HEADER = extern struct {
    RawValueLength: u16,
    pRawValue: ?*anyopaque,
};

const HTTP_REQUEST_HEADERS = extern struct {
    UnknownHeaderCount: u16,
    pUnknownHeaders: ?*anyopaque,
    TrailerCount: u16,
    pTrailers: ?*anyopaque,
    KnownHeaders: [41]HTTP_KNOWN_HEADER,
};
type
  HTTP_KNOWN_HEADER {.bycopy.} = object
    RawValueLength: uint16
    pRawValue: pointer

  HTTP_REQUEST_HEADERS {.bycopy.} = object
    UnknownHeaderCount: uint16
    pUnknownHeaders: pointer
    TrailerCount: uint16
    pTrailers: pointer
    KnownHeaders: array[41, HTTP_KNOWN_HEADER]
struct HTTP_KNOWN_HEADER
{
    ushort RawValueLength;
    void* pRawValue;
}

struct HTTP_REQUEST_HEADERS
{
    ushort UnknownHeaderCount;
    void* pUnknownHeaders;
    ushort TrailerCount;
    void* pTrailers;
    HTTP_KNOWN_HEADER[41] 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_REQUEST_HEADERS サイズ: 344 バイト(x86)
dim st, 86    ; 4byte整数×86(構造体サイズ 344 / 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, 328byte)  varptr(st)+16 を基点に操作(328byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; HTTP_REQUEST_HEADERS サイズ: 688 バイト(x64)
dim st, 172    ; 4byte整数×172(構造体サイズ 688 / 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, 656byte)  varptr(st)+32 を基点に操作(656byte:入れ子/配列)
; ※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_REQUEST_HEADERS
    #field short UnknownHeaderCount
    #field intptr pUnknownHeaders
    #field short TrailerCount
    #field intptr pTrailers
    #field HTTP_KNOWN_HEADER KnownHeaders 41
#endstruct

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