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

HTTP_SERVICE_CONFIG_SSL_PARAM

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

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

フィールド

フィールド型サイズx64x86説明
SslHashLengthDWORD4+0+0pSslHashが指すSSL証明書ハッシュのバイト長を示す。
pSslHashvoid*8/4+8+4使用するSSL証明書のハッシュ値へのポインタ。証明書ストア内の証明書を識別する。
AppIdGUID16+16+8このSSL構成を所有するアプリケーションを識別するGUID。
pSslCertStoreNameLPWSTR8/4+32+24証明書を検索する証明書ストア名を表すワイド文字列。NULLの場合は既定のMYストアを使用する。
DefaultCertCheckModeDWORD4+40+28クライアント証明書の検証モードを指定するフラグ。失効確認の無効化等を制御する。
DefaultRevocationFreshnessTimeDWORD4+44+32キャッシュ済み失効情報を再取得する間隔を秒単位で指定する。0は無効。
DefaultRevocationUrlRetrievalTimeoutDWORD4+48+36失効情報取得時のタイムアウトをミリ秒単位で指定する。
pDefaultSslCtlIdentifierLPWSTR8/4+56+40信頼する証明書発行者を制限する証明書信頼リスト(CTL)の識別子を表すワイド文字列。
pDefaultSslCtlStoreNameLPWSTR8/4+64+44CTLが格納されている証明書ストア名を表すワイド文字列。
DefaultFlagsDWORD4+72+48クライアント証明書交渉や検証の動作を制御するビットフラグの組み合わせ。

各言語での定義

#include <windows.h>

// HTTP_SERVICE_CONFIG_SSL_PARAM  (x64 80 / x86 52 バイト)
typedef struct HTTP_SERVICE_CONFIG_SSL_PARAM {
    DWORD SslHashLength;
    void* pSslHash;
    GUID AppId;
    LPWSTR pSslCertStoreName;
    DWORD DefaultCertCheckMode;
    DWORD DefaultRevocationFreshnessTime;
    DWORD DefaultRevocationUrlRetrievalTimeout;
    LPWSTR pDefaultSslCtlIdentifier;
    LPWSTR pDefaultSslCtlStoreName;
    DWORD DefaultFlags;
} HTTP_SERVICE_CONFIG_SSL_PARAM;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct HTTP_SERVICE_CONFIG_SSL_PARAM
{
    public uint SslHashLength;
    public IntPtr pSslHash;
    public Guid AppId;
    public IntPtr pSslCertStoreName;
    public uint DefaultCertCheckMode;
    public uint DefaultRevocationFreshnessTime;
    public uint DefaultRevocationUrlRetrievalTimeout;
    public IntPtr pDefaultSslCtlIdentifier;
    public IntPtr pDefaultSslCtlStoreName;
    public uint DefaultFlags;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure HTTP_SERVICE_CONFIG_SSL_PARAM
    Public SslHashLength As UInteger
    Public pSslHash As IntPtr
    Public AppId As Guid
    Public pSslCertStoreName As IntPtr
    Public DefaultCertCheckMode As UInteger
    Public DefaultRevocationFreshnessTime As UInteger
    Public DefaultRevocationUrlRetrievalTimeout As UInteger
    Public pDefaultSslCtlIdentifier As IntPtr
    Public pDefaultSslCtlStoreName As IntPtr
    Public DefaultFlags As UInteger
End Structure
import ctypes
from ctypes import wintypes

class HTTP_SERVICE_CONFIG_SSL_PARAM(ctypes.Structure):
    _fields_ = [
        ("SslHashLength", wintypes.DWORD),
        ("pSslHash", ctypes.c_void_p),
        ("AppId", GUID),
        ("pSslCertStoreName", ctypes.c_void_p),
        ("DefaultCertCheckMode", wintypes.DWORD),
        ("DefaultRevocationFreshnessTime", wintypes.DWORD),
        ("DefaultRevocationUrlRetrievalTimeout", wintypes.DWORD),
        ("pDefaultSslCtlIdentifier", ctypes.c_void_p),
        ("pDefaultSslCtlStoreName", ctypes.c_void_p),
        ("DefaultFlags", wintypes.DWORD),
    ]
#[repr(C)]
pub struct HTTP_SERVICE_CONFIG_SSL_PARAM {
    pub SslHashLength: u32,
    pub pSslHash: *mut core::ffi::c_void,
    pub AppId: GUID,
    pub pSslCertStoreName: *mut core::ffi::c_void,
    pub DefaultCertCheckMode: u32,
    pub DefaultRevocationFreshnessTime: u32,
    pub DefaultRevocationUrlRetrievalTimeout: u32,
    pub pDefaultSslCtlIdentifier: *mut core::ffi::c_void,
    pub pDefaultSslCtlStoreName: *mut core::ffi::c_void,
    pub DefaultFlags: u32,
}
import "golang.org/x/sys/windows"

type HTTP_SERVICE_CONFIG_SSL_PARAM struct {
	SslHashLength uint32
	pSslHash uintptr
	AppId windows.GUID
	pSslCertStoreName uintptr
	DefaultCertCheckMode uint32
	DefaultRevocationFreshnessTime uint32
	DefaultRevocationUrlRetrievalTimeout uint32
	pDefaultSslCtlIdentifier uintptr
	pDefaultSslCtlStoreName uintptr
	DefaultFlags uint32
}
type
  HTTP_SERVICE_CONFIG_SSL_PARAM = record
    SslHashLength: DWORD;
    pSslHash: Pointer;
    AppId: TGUID;
    pSslCertStoreName: Pointer;
    DefaultCertCheckMode: DWORD;
    DefaultRevocationFreshnessTime: DWORD;
    DefaultRevocationUrlRetrievalTimeout: DWORD;
    pDefaultSslCtlIdentifier: Pointer;
    pDefaultSslCtlStoreName: Pointer;
    DefaultFlags: DWORD;
  end;
const HTTP_SERVICE_CONFIG_SSL_PARAM = extern struct {
    SslHashLength: u32,
    pSslHash: ?*anyopaque,
    AppId: GUID,
    pSslCertStoreName: ?*anyopaque,
    DefaultCertCheckMode: u32,
    DefaultRevocationFreshnessTime: u32,
    DefaultRevocationUrlRetrievalTimeout: u32,
    pDefaultSslCtlIdentifier: ?*anyopaque,
    pDefaultSslCtlStoreName: ?*anyopaque,
    DefaultFlags: u32,
};
type
  HTTP_SERVICE_CONFIG_SSL_PARAM {.bycopy.} = object
    SslHashLength: uint32
    pSslHash: pointer
    AppId: GUID
    pSslCertStoreName: pointer
    DefaultCertCheckMode: uint32
    DefaultRevocationFreshnessTime: uint32
    DefaultRevocationUrlRetrievalTimeout: uint32
    pDefaultSslCtlIdentifier: pointer
    pDefaultSslCtlStoreName: pointer
    DefaultFlags: uint32
struct HTTP_SERVICE_CONFIG_SSL_PARAM
{
    uint SslHashLength;
    void* pSslHash;
    GUID AppId;
    void* pSslCertStoreName;
    uint DefaultCertCheckMode;
    uint DefaultRevocationFreshnessTime;
    uint DefaultRevocationUrlRetrievalTimeout;
    void* pDefaultSslCtlIdentifier;
    void* pDefaultSslCtlStoreName;
    uint DefaultFlags;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; HTTP_SERVICE_CONFIG_SSL_PARAM サイズ: 52 バイト(x86)
dim st, 13    ; 4byte整数×13(構造体サイズ 52 / 4 切り上げ)
; SslHashLength : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; pSslHash : void* (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; AppId : GUID (+8, 16byte)  varptr(st)+8 を基点に操作(16byte:入れ子/配列)
; pSslCertStoreName : LPWSTR (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; DefaultCertCheckMode : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; DefaultRevocationFreshnessTime : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; DefaultRevocationUrlRetrievalTimeout : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; pDefaultSslCtlIdentifier : LPWSTR (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; pDefaultSslCtlStoreName : LPWSTR (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; DefaultFlags : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; HTTP_SERVICE_CONFIG_SSL_PARAM サイズ: 80 バイト(x64)
dim st, 20    ; 4byte整数×20(構造体サイズ 80 / 4 切り上げ)
; SslHashLength : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; pSslHash : void* (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; AppId : GUID (+16, 16byte)  varptr(st)+16 を基点に操作(16byte:入れ子/配列)
; pSslCertStoreName : LPWSTR (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; DefaultCertCheckMode : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; DefaultRevocationFreshnessTime : DWORD (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; DefaultRevocationUrlRetrievalTimeout : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; pDefaultSslCtlIdentifier : LPWSTR (+56, 8byte)  qpoke st,56,値 / qpeek(st,56)  ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; pDefaultSslCtlStoreName : LPWSTR (+64, 8byte)  qpoke st,64,値 / qpeek(st,64)  ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; DefaultFlags : DWORD (+72, 4byte)  st.18 = 値  /  値 = st.18   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global GUID, pack=1
    #field int Data1
    #field short Data2
    #field short Data3
    #field byte Data4 8
#endstruct

#defstruct global HTTP_SERVICE_CONFIG_SSL_PARAM
    #field int SslHashLength
    #field intptr pSslHash
    #field GUID AppId
    #field intptr pSslCertStoreName
    #field int DefaultCertCheckMode
    #field int DefaultRevocationFreshnessTime
    #field int DefaultRevocationUrlRetrievalTimeout
    #field intptr pDefaultSslCtlIdentifier
    #field intptr pDefaultSslCtlStoreName
    #field int DefaultFlags
#endstruct

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