Win32 API 日本語リファレンス
ホームNetworkManagement.WindowsFilteringPlatform › IKEEXT_CERTIFICATE_AUTHENTICATION1

IKEEXT_CERTIFICATE_AUTHENTICATION1

構造体
サイズx64: 56 バイト / x86: 28 バイト

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

フィールド

フィールドサイズx64x86説明
inboundConfigTypeIKEEXT_CERT_CONFIG_TYPE4+0+0

受信ピア証明書の検証に使用する証明書構成の種類です。

詳細については IKEEXT_CERT_CONFIG_TYPE を参照してください。

Anonymous1_Anonymous1_e__Union8/4+8+4受信構成の詳細を保持する無名共用体。
outboundConfigTypeIKEEXT_CERT_CONFIG_TYPE4+16+8

送信するローカル証明書の検証に使用する証明書構成の種類です。

詳細については IKEEXT_CERT_CONFIG_TYPE を参照してください。

Anonymous2_Anonymous2_e__Union8/4+24+12送信構成の詳細を保持する無名共用体。
flagsIKEEXT_CERT_AUTH4+32+16

証明書認証の特性を指定する、次の値の組み合わせです。

IKE/AuthIP 証明書認証フラグ 意味
IKEEXT_CERT_AUTH_FLAG_SSL_ONE_WAY
SSL の一方向認証を有効にします。

AuthIP にのみ適用されます。

IKEEXT_CERT_AUTH_FLAG_DISABLE_CRL_CHECK
CRL のチェックを無効にします。既定では弱い CRL チェックが有効になっています。弱いチェックとは、 CRL の参照に成功し、かつその証明書が失効していると判明した場合に限り、 証明書を拒否することを意味します。
IKEEXT_CERT_AUTH_ENABLE_CRL_CHECK_STRONG
強い CRL チェックを有効にします。強いチェックとは、証明書が失効していると判明した場合、 または失効チェックの実行中にその他のエラー (たとえば CRL を取得できなかった場合) が発生した場合に、証明書を拒否することを意味します。
IKEEXT_CERT_AUTH_DISABLE_SSL_CERT_VALIDATION
SSL サーバー認証の拡張キー使用法 (EKU) のチェックを無効にします。その他の種類の AuthIP の検証は引き続き実行されます。

AuthIP にのみ適用されます。

IKEEXT_CERT_AUTH_ALLOW_HTTP_CERT_LOOKUP
HTTP URL からピアの証明書情報を参照することを許可します。

IKEv2 にのみ適用されます。

IKEEXT_CERT_AUTH_URL_CONTAINS_BUNDLE
証明書認証ポリシーで指定された URL が、エンコードされた証明書バンドルを指します。 このフラグが指定されていない場合、IKEv2 は URL がエンコードされた証明書を 指しているものとみなします。

IKEv2 にのみ適用されます。

localCertLocationUrlFWP_BYTE_BLOB16/8+40+20

ローカル コンピューターをピアに対して認証するために IKEv2 が使用する、 エンコードされた証明書または証明書バンドルを指す HTTP URL です。

IKEv2 にのみ適用されます。

詳細については FWP_BYTE_BLOB を参照してください。

共用体: _Anonymous1_e__Union x64 8B / x86 4B

フィールドサイズx64x86説明
Anonymous_Anonymous_e__Struct8/4+0+0
inboundEnterpriseStoreConfigIKEEXT_CERT_ROOT_CONFIG0*8/4+0+0

ピアの証明書チェーンを検証するためのエンタープライズ ストアの構成です。

inboundConfigTypeIKEEXT_CERT_CONFIG_ENTERPRISE_STORE の場合に使用できます。

詳細については IKEEXT_CERT_ROOT_CONFIG0 を参照してください。

inboundTrustedRootStoreConfigIKEEXT_CERT_ROOT_CONFIG0*8/4+0+0

ピアの証明書チェーンを検証するための信頼されたルート ストアの構成です。

inboundConfigTypeIKEEXT_CERT_CONFIG_TRUSTED_ROOT_STORE の場合に使用できます。

詳細については IKEEXT_CERT_ROOT_CONFIG0 を参照してください。

共用体: _Anonymous2_e__Union x64 8B / x86 4B

フィールドサイズx64x86説明
Anonymous_Anonymous_e__Struct8/4+0+0
outboundEnterpriseStoreConfigIKEEXT_CERT_ROOT_CONFIG0*8/4+0+0

証明書チェーンを選択するためのエンタープライズ ストアの構成です。

outboundConfigTypeIKEEXT_CERT_CONFIG_ENTERPRISE_STORE の場合に使用できます。

詳細については IKEEXT_CERT_ROOT_CONFIG0 を参照してください。

outboundTrustedRootStoreConfigIKEEXT_CERT_ROOT_CONFIG0*8/4+0+0

証明書チェーンを選択するための信頼されたルート ストアの構成です。

outboundConfigTypeIKEEXT_CERT_CONFIG_ROOT_STORE の場合に使用できます。

詳細については IKEEXT_CERT_ROOT_CONFIG0 を参照してください。

公式ドキュメント

IKEEXT_CERTIFICATE_AUTHENTICATION2 を使用できます。Windows Vista では IKEEXT_CERTIFICATE_AUTHENTICATION0 を使用できます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// FWP_BYTE_BLOB  (x64 16 / x86 8 バイト)
typedef struct FWP_BYTE_BLOB {
    DWORD size;
    BYTE* data;
} FWP_BYTE_BLOB;

// IKEEXT_CERTIFICATE_AUTHENTICATION1  (x64 56 / x86 28 バイト)
typedef struct IKEEXT_CERTIFICATE_AUTHENTICATION1 {
    IKEEXT_CERT_CONFIG_TYPE inboundConfigType;
    _Anonymous1_e__Union Anonymous1;
    IKEEXT_CERT_CONFIG_TYPE outboundConfigType;
    _Anonymous2_e__Union Anonymous2;
    IKEEXT_CERT_AUTH flags;
    FWP_BYTE_BLOB localCertLocationUrl;
} IKEEXT_CERTIFICATE_AUTHENTICATION1;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct FWP_BYTE_BLOB
{
    public uint size;
    public IntPtr data;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct IKEEXT_CERTIFICATE_AUTHENTICATION1
{
    public int inboundConfigType;
    public _Anonymous1_e__Union Anonymous1;
    public int outboundConfigType;
    public _Anonymous2_e__Union Anonymous2;
    public uint flags;
    public FWP_BYTE_BLOB localCertLocationUrl;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure FWP_BYTE_BLOB
    Public size As UInteger
    Public data As IntPtr
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure IKEEXT_CERTIFICATE_AUTHENTICATION1
    Public inboundConfigType As Integer
    Public Anonymous1 As _Anonymous1_e__Union
    Public outboundConfigType As Integer
    Public Anonymous2 As _Anonymous2_e__Union
    Public flags As UInteger
    Public localCertLocationUrl As FWP_BYTE_BLOB
End Structure
import ctypes
from ctypes import wintypes

class FWP_BYTE_BLOB(ctypes.Structure):
    _fields_ = [
        ("size", wintypes.DWORD),
        ("data", ctypes.c_void_p),
    ]

class IKEEXT_CERTIFICATE_AUTHENTICATION1(ctypes.Structure):
    _fields_ = [
        ("inboundConfigType", ctypes.c_int),
        ("Anonymous1", _Anonymous1_e__Union),
        ("outboundConfigType", ctypes.c_int),
        ("Anonymous2", _Anonymous2_e__Union),
        ("flags", wintypes.DWORD),
        ("localCertLocationUrl", FWP_BYTE_BLOB),
    ]
#[repr(C)]
pub struct FWP_BYTE_BLOB {
    pub size: u32,
    pub data: *mut core::ffi::c_void,
}

#[repr(C)]
pub struct IKEEXT_CERTIFICATE_AUTHENTICATION1 {
    pub inboundConfigType: i32,
    pub Anonymous1: _Anonymous1_e__Union,
    pub outboundConfigType: i32,
    pub Anonymous2: _Anonymous2_e__Union,
    pub flags: u32,
    pub localCertLocationUrl: FWP_BYTE_BLOB,
}
import "golang.org/x/sys/windows"

type FWP_BYTE_BLOB struct {
	size uint32
	data uintptr
}

type IKEEXT_CERTIFICATE_AUTHENTICATION1 struct {
	inboundConfigType int32
	Anonymous1 _Anonymous1_e__Union
	outboundConfigType int32
	Anonymous2 _Anonymous2_e__Union
	flags uint32
	localCertLocationUrl FWP_BYTE_BLOB
}
type
  FWP_BYTE_BLOB = record
    size: DWORD;
    data: Pointer;
  end;

  IKEEXT_CERTIFICATE_AUTHENTICATION1 = record
    inboundConfigType: Integer;
    Anonymous1: _Anonymous1_e__Union;
    outboundConfigType: Integer;
    Anonymous2: _Anonymous2_e__Union;
    flags: DWORD;
    localCertLocationUrl: FWP_BYTE_BLOB;
  end;
const FWP_BYTE_BLOB = extern struct {
    size: u32,
    data: ?*anyopaque,
};

const IKEEXT_CERTIFICATE_AUTHENTICATION1 = extern struct {
    inboundConfigType: i32,
    Anonymous1: _Anonymous1_e__Union,
    outboundConfigType: i32,
    Anonymous2: _Anonymous2_e__Union,
    flags: u32,
    localCertLocationUrl: FWP_BYTE_BLOB,
};
type
  FWP_BYTE_BLOB {.bycopy.} = object
    size: uint32
    data: pointer

  IKEEXT_CERTIFICATE_AUTHENTICATION1 {.bycopy.} = object
    inboundConfigType: int32
    Anonymous1: _Anonymous1_e__Union
    outboundConfigType: int32
    Anonymous2: _Anonymous2_e__Union
    flags: uint32
    localCertLocationUrl: FWP_BYTE_BLOB
struct FWP_BYTE_BLOB
{
    uint size;
    void* data;
}

struct IKEEXT_CERTIFICATE_AUTHENTICATION1
{
    int inboundConfigType;
    _Anonymous1_e__Union Anonymous1;
    int outboundConfigType;
    _Anonymous2_e__Union Anonymous2;
    uint flags;
    FWP_BYTE_BLOB localCertLocationUrl;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; IKEEXT_CERTIFICATE_AUTHENTICATION1 サイズ: 28 バイト(x86)
dim st, 7    ; 4byte整数×7(構造体サイズ 28 / 4 切り上げ)
; inboundConfigType : IKEEXT_CERT_CONFIG_TYPE (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Anonymous1 : _Anonymous1_e__Union (+4, 4byte)  varptr(st)+4 を基点に操作(4byte:入れ子/配列)
; outboundConfigType : IKEEXT_CERT_CONFIG_TYPE (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; Anonymous2 : _Anonymous2_e__Union (+12, 4byte)  varptr(st)+12 を基点に操作(4byte:入れ子/配列)
; flags : IKEEXT_CERT_AUTH (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; localCertLocationUrl : FWP_BYTE_BLOB (+20, 8byte)  varptr(st)+20 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; IKEEXT_CERTIFICATE_AUTHENTICATION1 サイズ: 56 バイト(x64)
dim st, 14    ; 4byte整数×14(構造体サイズ 56 / 4 切り上げ)
; inboundConfigType : IKEEXT_CERT_CONFIG_TYPE (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Anonymous1 : _Anonymous1_e__Union (+8, 8byte)  varptr(st)+8 を基点に操作(8byte:入れ子/配列)
; outboundConfigType : IKEEXT_CERT_CONFIG_TYPE (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; Anonymous2 : _Anonymous2_e__Union (+24, 8byte)  varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; flags : IKEEXT_CERT_AUTH (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; localCertLocationUrl : FWP_BYTE_BLOB (+40, 16byte)  varptr(st)+40 を基点に操作(16byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global FWP_BYTE_BLOB
    #field int size
    #field intptr data
#endstruct

#defstruct global IKEEXT_CERTIFICATE_AUTHENTICATION1
    #field int inboundConfigType
    #field byte Anonymous1 8
    #field int outboundConfigType
    #field byte Anonymous2 8
    #field int flags
    #field FWP_BYTE_BLOB localCertLocationUrl
#endstruct

stdim st, IKEEXT_CERTIFICATE_AUTHENTICATION1        ; NSTRUCT 変数を確保
st->inboundConfigType = 100
mes "inboundConfigType=" + st->inboundConfigType
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。