HTTP_SERVICE_CONFIG_SSL_SNI_QUERY
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| QueryDesc | HTTP_SERVICE_CONFIG_QUERY_TYPE | 4 | +0 | +0 | HTTP_SERVICE_CONFIG_QUERY_TYPE 列挙型の次の値のいずれかを指定します。
| ||||||
| KeyDesc | HTTP_SERVICE_CONFIG_SSL_SNI_KEY | 136 | +8 | +8 | QueryDesc パラメーターが HttpServiceConfigQueryExact と等しい場合、KeyDesc には照会する SSL SNI 証明書レコードを識別する HTTP_SERVICE_CONFIG_SSL_SNI_KEY 構造体を格納します。QueryDesc パラメーターが HTTPServiceConfigQueryNext と等しい場合、KeyDesc は無視されます。 | ||||||
| dwToken | DWORD | 4 | +144 | +144 | QueryDesc パラメーターが HTTPServiceConfigQueryNext と等しい場合、dwToken は HttpQueryServiceConfiguration 関数の 1 回目の呼び出しでは 0、2 回目の呼び出しでは 1、3 回目の呼び出しでは 2 というように指定し、すべての SSL 証明書レコードが返されるまで続けます。すべて返された時点で HttpQueryServiceConfiguration は ERROR_NO_MORE_ITEMS を返します。 QueryDesc パラメーターが HttpServiceConfigQueryExact と等しい場合、dwToken は無視されます。 |
公式ドキュメント
HTTP_SERVICE_CONFIG_SSL_SNI_QUERY 構造体は、SSL SNI ストア内で照会する特定の Secure Sockets Layer (SSL) Server Name Indication (SNI) 証明書レコードを指定するために使用します。この構造体は、ConfigId パラメーターが HttpServiceConfigSslSniCertInfo に設定されている場合に、pInputConfigInfo パラメーターを使用して HttpQueryServiceConfiguration 関数に渡されます。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// SOCKADDR_STORAGE (x64 128 / x86 128 バイト)
typedef struct SOCKADDR_STORAGE {
ADDRESS_FAMILY ss_family;
CHAR __ss_pad1[6];
LONGLONG __ss_align;
CHAR __ss_pad2[112];
} SOCKADDR_STORAGE;
// HTTP_SERVICE_CONFIG_SSL_SNI_KEY (x64 136 / x86 136 バイト)
typedef struct HTTP_SERVICE_CONFIG_SSL_SNI_KEY {
SOCKADDR_STORAGE IpPort;
LPWSTR Host;
} HTTP_SERVICE_CONFIG_SSL_SNI_KEY;
// HTTP_SERVICE_CONFIG_SSL_SNI_QUERY (x64 152 / x86 152 バイト)
typedef struct HTTP_SERVICE_CONFIG_SSL_SNI_QUERY {
HTTP_SERVICE_CONFIG_QUERY_TYPE QueryDesc;
HTTP_SERVICE_CONFIG_SSL_SNI_KEY KeyDesc;
DWORD dwToken;
} HTTP_SERVICE_CONFIG_SSL_SNI_QUERY;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SOCKADDR_STORAGE
{
public ushort ss_family;
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 6)] public sbyte[] __ss_pad1;
public long __ss_align;
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 112)] public sbyte[] __ss_pad2;
}
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct HTTP_SERVICE_CONFIG_SSL_SNI_KEY
{
public SOCKADDR_STORAGE IpPort;
public IntPtr Host;
}
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct HTTP_SERVICE_CONFIG_SSL_SNI_QUERY
{
public int QueryDesc;
public HTTP_SERVICE_CONFIG_SSL_SNI_KEY KeyDesc;
public uint dwToken;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SOCKADDR_STORAGE
Public ss_family As UShort
<MarshalAs(UnmanagedType.ByValArray, SizeConst:=6)> Public __ss_pad1() As SByte
Public __ss_align As Long
<MarshalAs(UnmanagedType.ByValArray, SizeConst:=112)> Public __ss_pad2() As SByte
End Structure
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure HTTP_SERVICE_CONFIG_SSL_SNI_KEY
Public IpPort As SOCKADDR_STORAGE
Public Host As IntPtr
End Structure
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure HTTP_SERVICE_CONFIG_SSL_SNI_QUERY
Public QueryDesc As Integer
Public KeyDesc As HTTP_SERVICE_CONFIG_SSL_SNI_KEY
Public dwToken As UInteger
End Structureimport ctypes
from ctypes import wintypes
class SOCKADDR_STORAGE(ctypes.Structure):
_fields_ = [
("ss_family", ctypes.c_ushort),
("__ss_pad1", ctypes.c_byte * 6),
("__ss_align", ctypes.c_longlong),
("__ss_pad2", ctypes.c_byte * 112),
]
class HTTP_SERVICE_CONFIG_SSL_SNI_KEY(ctypes.Structure):
_fields_ = [
("IpPort", SOCKADDR_STORAGE),
("Host", ctypes.c_void_p),
]
class HTTP_SERVICE_CONFIG_SSL_SNI_QUERY(ctypes.Structure):
_fields_ = [
("QueryDesc", ctypes.c_int),
("KeyDesc", HTTP_SERVICE_CONFIG_SSL_SNI_KEY),
("dwToken", wintypes.DWORD),
]#[repr(C)]
pub struct SOCKADDR_STORAGE {
pub ss_family: u16,
pub __ss_pad1: [i8; 6],
pub __ss_align: i64,
pub __ss_pad2: [i8; 112],
}
#[repr(C)]
pub struct HTTP_SERVICE_CONFIG_SSL_SNI_KEY {
pub IpPort: SOCKADDR_STORAGE,
pub Host: *mut core::ffi::c_void,
}
#[repr(C)]
pub struct HTTP_SERVICE_CONFIG_SSL_SNI_QUERY {
pub QueryDesc: i32,
pub KeyDesc: HTTP_SERVICE_CONFIG_SSL_SNI_KEY,
pub dwToken: u32,
}import "golang.org/x/sys/windows"
type SOCKADDR_STORAGE struct {
ss_family uint16
__ss_pad1 [6]int8
__ss_align int64
__ss_pad2 [112]int8
}
type HTTP_SERVICE_CONFIG_SSL_SNI_KEY struct {
IpPort SOCKADDR_STORAGE
Host uintptr
}
type HTTP_SERVICE_CONFIG_SSL_SNI_QUERY struct {
QueryDesc int32
KeyDesc HTTP_SERVICE_CONFIG_SSL_SNI_KEY
dwToken uint32
}type
SOCKADDR_STORAGE = record
ss_family: Word;
__ss_pad1: array[0..5] of Shortint;
__ss_align: Int64;
__ss_pad2: array[0..111] of Shortint;
end;
HTTP_SERVICE_CONFIG_SSL_SNI_KEY = record
IpPort: SOCKADDR_STORAGE;
Host: Pointer;
end;
HTTP_SERVICE_CONFIG_SSL_SNI_QUERY = record
QueryDesc: Integer;
KeyDesc: HTTP_SERVICE_CONFIG_SSL_SNI_KEY;
dwToken: DWORD;
end;const SOCKADDR_STORAGE = extern struct {
ss_family: u16,
__ss_pad1: [6]i8,
__ss_align: i64,
__ss_pad2: [112]i8,
};
const HTTP_SERVICE_CONFIG_SSL_SNI_KEY = extern struct {
IpPort: SOCKADDR_STORAGE,
Host: ?*anyopaque,
};
const HTTP_SERVICE_CONFIG_SSL_SNI_QUERY = extern struct {
QueryDesc: i32,
KeyDesc: HTTP_SERVICE_CONFIG_SSL_SNI_KEY,
dwToken: u32,
};type
SOCKADDR_STORAGE {.bycopy.} = object
ss_family: uint16
__ss_pad1: array[6, int8]
__ss_align: int64
__ss_pad2: array[112, int8]
HTTP_SERVICE_CONFIG_SSL_SNI_KEY {.bycopy.} = object
IpPort: SOCKADDR_STORAGE
Host: pointer
HTTP_SERVICE_CONFIG_SSL_SNI_QUERY {.bycopy.} = object
QueryDesc: int32
KeyDesc: HTTP_SERVICE_CONFIG_SSL_SNI_KEY
dwToken: uint32struct SOCKADDR_STORAGE
{
ushort ss_family;
byte[6] __ss_pad1;
long __ss_align;
byte[112] __ss_pad2;
}
struct HTTP_SERVICE_CONFIG_SSL_SNI_KEY
{
SOCKADDR_STORAGE IpPort;
void* Host;
}
struct HTTP_SERVICE_CONFIG_SSL_SNI_QUERY
{
int QueryDesc;
HTTP_SERVICE_CONFIG_SSL_SNI_KEY KeyDesc;
uint dwToken;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; HTTP_SERVICE_CONFIG_SSL_SNI_QUERY サイズ: 152 バイト(x64)
dim st, 38 ; 4byte整数×38(構造体サイズ 152 / 4 切り上げ)
; QueryDesc : HTTP_SERVICE_CONFIG_QUERY_TYPE (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; KeyDesc : HTTP_SERVICE_CONFIG_SSL_SNI_KEY (+8, 136byte) varptr(st)+8 を基点に操作(136byte:入れ子/配列)
; dwToken : DWORD (+144, 4byte) st.36 = 値 / 値 = st.36 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global SOCKADDR_STORAGE
#field short ss_family
#field byte __ss_pad1 6
#field int64 __ss_align
#field byte __ss_pad2 112
#endstruct
#defstruct global HTTP_SERVICE_CONFIG_SSL_SNI_KEY
#field SOCKADDR_STORAGE IpPort
#field intptr Host
#endstruct
#defstruct global HTTP_SERVICE_CONFIG_SSL_SNI_QUERY
#field int QueryDesc
#field HTTP_SERVICE_CONFIG_SSL_SNI_KEY KeyDesc
#field int dwToken
#endstruct
stdim st, HTTP_SERVICE_CONFIG_SSL_SNI_QUERY ; NSTRUCT 変数を確保
st->QueryDesc = 100
mes "QueryDesc=" + st->QueryDesc