ホーム › Security.ExtensibleAuthenticationProtocol › EapHostPeerMethodResult

EapHostPeerMethodResult

構造体

サイズx64: 72 バイト / x86: 48 バイト

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

フィールド

フィールド	型	サイズ	x64	x86	説明
fIsSuccess	BOOL	4	+0	+0	TRUE の場合、サプリカントは正常に認証されました。FALSE の場合は認証されませんでした。
dwFailureReasonCode	DWORD	4	+4	+4	サプリカントを認証できなかった場合に、その理由コードを格納します。
fSaveConnectionData	BOOL	4	+8	+8	TRUE の場合、pConnectionData に指定された接続データをディスクに永続化する必要があります。それ以外の場合は保存する必要はありません。
dwSizeofConnectionData	DWORD	4	+12	+12	pConnectionData のサイズ (バイト単位)。
pConnectionData	BYTE*	8/4	+16	+16	EAP 認証セッションが行われる接続に関する情報を格納するバイトバッファーへのポインター。
fSaveUserData	BOOL	4	+24	+20	TRUE の場合、pUserData に指定されたユーザーデータをディスクに永続化する必要があります。それ以外の場合は保存する必要はありません。
dwSizeofUserData	DWORD	4	+28	+24	pUserData のサイズ (バイト単位)。
pUserData	BYTE*	8/4	+32	+28	EAP 認証セッションを要求したサプリカントのユーザーに関する情報を格納するバイトバッファーへのポインター。
pAttribArray	EAP_ATTRIBUTES*	8/4	+40	+32	認証セッションの属性を格納する EAP_ATTRIBUTES 配列構造体へのポインター。
isolationState	ISOLATION_STATE	4	+48	+36	認証セッションの接続の分離状態を示す ISOLATION_STATE の値。
pEapMethodInfo	EAP_METHOD_INFO*	8/4	+56	+40	サプリカントの認証を実行した EAP メソッドに関する情報を格納する EAP_METHOD_INFO 構造体へのポインター。
pEapError	EAP_ERROR*	8/4	+64	+44	この関数呼び出しの実行中に EAPHost が発生させたエラーを格納する EAP_ERROR 構造体へのポインター。エラーデータの使用後は、EapHostPeerFreeEapError を呼び出してこのメモリを解放する必要があります。

公式ドキュメント

EapHostPeerMethodResult 構造体は、認証セッション中に EAPHost によって生成され、その後 EAP メソッドに渡される結果データを格納します。

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

各言語での定義

#include <windows.h>

// EapHostPeerMethodResult  (x64 72 / x86 48 バイト)
typedef struct EapHostPeerMethodResult {
    BOOL fIsSuccess;
    DWORD dwFailureReasonCode;
    BOOL fSaveConnectionData;
    DWORD dwSizeofConnectionData;
    BYTE* pConnectionData;
    BOOL fSaveUserData;
    DWORD dwSizeofUserData;
    BYTE* pUserData;
    EAP_ATTRIBUTES* pAttribArray;
    ISOLATION_STATE isolationState;
    EAP_METHOD_INFO* pEapMethodInfo;
    EAP_ERROR* pEapError;
} EapHostPeerMethodResult;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct EapHostPeerMethodResult
{
    [MarshalAs(UnmanagedType.Bool)] public bool fIsSuccess;
    public uint dwFailureReasonCode;
    [MarshalAs(UnmanagedType.Bool)] public bool fSaveConnectionData;
    public uint dwSizeofConnectionData;
    public IntPtr pConnectionData;
    [MarshalAs(UnmanagedType.Bool)] public bool fSaveUserData;
    public uint dwSizeofUserData;
    public IntPtr pUserData;
    public IntPtr pAttribArray;
    public int isolationState;
    public IntPtr pEapMethodInfo;
    public IntPtr pEapError;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure EapHostPeerMethodResult
    <MarshalAs(UnmanagedType.Bool)> Public fIsSuccess As Boolean
    Public dwFailureReasonCode As UInteger
    <MarshalAs(UnmanagedType.Bool)> Public fSaveConnectionData As Boolean
    Public dwSizeofConnectionData As UInteger
    Public pConnectionData As IntPtr
    <MarshalAs(UnmanagedType.Bool)> Public fSaveUserData As Boolean
    Public dwSizeofUserData As UInteger
    Public pUserData As IntPtr
    Public pAttribArray As IntPtr
    Public isolationState As Integer
    Public pEapMethodInfo As IntPtr
    Public pEapError As IntPtr
End Structure

import ctypes
from ctypes import wintypes

class EapHostPeerMethodResult(ctypes.Structure):
    _fields_ = [
        ("fIsSuccess", wintypes.BOOL),
        ("dwFailureReasonCode", wintypes.DWORD),
        ("fSaveConnectionData", wintypes.BOOL),
        ("dwSizeofConnectionData", wintypes.DWORD),
        ("pConnectionData", ctypes.c_void_p),
        ("fSaveUserData", wintypes.BOOL),
        ("dwSizeofUserData", wintypes.DWORD),
        ("pUserData", ctypes.c_void_p),
        ("pAttribArray", ctypes.c_void_p),
        ("isolationState", ctypes.c_int),
        ("pEapMethodInfo", ctypes.c_void_p),
        ("pEapError", ctypes.c_void_p),
    ]

#[repr(C)]
pub struct EapHostPeerMethodResult {
    pub fIsSuccess: i32,
    pub dwFailureReasonCode: u32,
    pub fSaveConnectionData: i32,
    pub dwSizeofConnectionData: u32,
    pub pConnectionData: *mut core::ffi::c_void,
    pub fSaveUserData: i32,
    pub dwSizeofUserData: u32,
    pub pUserData: *mut core::ffi::c_void,
    pub pAttribArray: *mut core::ffi::c_void,
    pub isolationState: i32,
    pub pEapMethodInfo: *mut core::ffi::c_void,
    pub pEapError: *mut core::ffi::c_void,
}

import "golang.org/x/sys/windows"

type EapHostPeerMethodResult struct {
	fIsSuccess int32
	dwFailureReasonCode uint32
	fSaveConnectionData int32
	dwSizeofConnectionData uint32
	pConnectionData uintptr
	fSaveUserData int32
	dwSizeofUserData uint32
	pUserData uintptr
	pAttribArray uintptr
	isolationState int32
	pEapMethodInfo uintptr
	pEapError uintptr
}

type
  EapHostPeerMethodResult = record
    fIsSuccess: BOOL;
    dwFailureReasonCode: DWORD;
    fSaveConnectionData: BOOL;
    dwSizeofConnectionData: DWORD;
    pConnectionData: Pointer;
    fSaveUserData: BOOL;
    dwSizeofUserData: DWORD;
    pUserData: Pointer;
    pAttribArray: Pointer;
    isolationState: Integer;
    pEapMethodInfo: Pointer;
    pEapError: Pointer;
  end;

const EapHostPeerMethodResult = extern struct {
    fIsSuccess: i32,
    dwFailureReasonCode: u32,
    fSaveConnectionData: i32,
    dwSizeofConnectionData: u32,
    pConnectionData: ?*anyopaque,
    fSaveUserData: i32,
    dwSizeofUserData: u32,
    pUserData: ?*anyopaque,
    pAttribArray: ?*anyopaque,
    isolationState: i32,
    pEapMethodInfo: ?*anyopaque,
    pEapError: ?*anyopaque,
};

type
  EapHostPeerMethodResult {.bycopy.} = object
    fIsSuccess: int32
    dwFailureReasonCode: uint32
    fSaveConnectionData: int32
    dwSizeofConnectionData: uint32
    pConnectionData: pointer
    fSaveUserData: int32
    dwSizeofUserData: uint32
    pUserData: pointer
    pAttribArray: pointer
    isolationState: int32
    pEapMethodInfo: pointer
    pEapError: pointer

struct EapHostPeerMethodResult
{
    int fIsSuccess;
    uint dwFailureReasonCode;
    int fSaveConnectionData;
    uint dwSizeofConnectionData;
    void* pConnectionData;
    int fSaveUserData;
    uint dwSizeofUserData;
    void* pUserData;
    void* pAttribArray;
    int isolationState;
    void* pEapMethodInfo;
    void* pEapError;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; EapHostPeerMethodResult サイズ: 48 バイト(x86)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; fIsSuccess : BOOL (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwFailureReasonCode : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; fSaveConnectionData : BOOL (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; dwSizeofConnectionData : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; pConnectionData : BYTE* (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; fSaveUserData : BOOL (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; dwSizeofUserData : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; pUserData : BYTE* (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; pAttribArray : EAP_ATTRIBUTES* (+32, 4byte)  varptr(st)+32 を基点に操作(4byte:入れ子/配列)
; isolationState : ISOLATION_STATE (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; pEapMethodInfo : EAP_METHOD_INFO* (+40, 4byte)  varptr(st)+40 を基点に操作(4byte:入れ子/配列)
; pEapError : EAP_ERROR* (+44, 4byte)  varptr(st)+44 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; EapHostPeerMethodResult サイズ: 72 バイト(x64)
dim st, 18    ; 4byte整数×18(構造体サイズ 72 / 4 切り上げ)
; fIsSuccess : BOOL (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwFailureReasonCode : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; fSaveConnectionData : BOOL (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; dwSizeofConnectionData : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; pConnectionData : BYTE* (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; fSaveUserData : BOOL (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; dwSizeofUserData : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; pUserData : BYTE* (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; pAttribArray : EAP_ATTRIBUTES* (+40, 8byte)  varptr(st)+40 を基点に操作(8byte:入れ子/配列)
; isolationState : ISOLATION_STATE (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; pEapMethodInfo : EAP_METHOD_INFO* (+56, 8byte)  varptr(st)+56 を基点に操作(8byte:入れ子/配列)
; pEapError : EAP_ERROR* (+64, 8byte)  varptr(st)+64 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global EapHostPeerMethodResult
    #field bool fIsSuccess
    #field int dwFailureReasonCode
    #field bool fSaveConnectionData
    #field int dwSizeofConnectionData
    #field intptr pConnectionData
    #field bool fSaveUserData
    #field int dwSizeofUserData
    #field intptr pUserData
    #field intptr pAttribArray
    #field int isolationState
    #field intptr pEapMethodInfo
    #field intptr pEapError
#endstruct

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

EapHostPeerMethodResult

フィールド

公式ドキュメント

各言語での定義

HSP用 定義

HSP用定義