Win32 API 日本語リファレンス
ホーム › Security.ExtensibleAuthenticationProtocol › EAP_CONFIG_INPUT_FIELD_DATA

EAP_CONFIG_INPUT_FIELD_DATA

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

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

フィールド

フィールド型サイズx64x86説明
dwSizeDWORD4+0+0EAP_CONFIG_INPUT_FIELD_DATA 構造体のサイズ (バイト単位)。このフィールドはバージョン管理のために使用されます。
TypeEAP_CONFIG_INPUT_FIELD_TYPE4+4+4入力フィールドの種類を指定する EAP_CONFIG_INPUT_FIELD_TYPE 列挙型の値です。
dwFlagPropsDWORD4+8+8

EAP 構成入力フィールドのプロパティを表すフラグ値のセットです。

値 意味
EAP_UI_INPUT_FIELD_PROPS_DEFAULT
0X00000000
Windows Vista with SP1 以降: UI に表示される入力フィールド項目の既定のプロパティ値を表します。
EAP_CONFIG_INPUT_FIELD_PROPS_DEFAULT
0X00000000
UI に表示される構成入力フィールド項目の既定のプロパティ値を表します。
EAP_UI_INPUT_FIELD_PROPS_NON_DISPLAYABLE
0X00000001
Windows Vista with SP1 以降: 入力フィールド項目を UI に表示しないことを指定します (パスワードや PIN 番号など)。
EAP_CONFIG_INPUT_FIELD_PROPS_NON_DISPLAYABLE
0X00000001
構成入力フィールド項目を UI に表示しないことを指定します (パスワードや PIN 番号など)。
EAP_UI_INPUT_FIELD_PROPS_NON_PERSIST
0X00000002
Windows Vista with SP1 以降: EAP メソッドがフィールドデータをキャッシュしないことを示します。ローミングのためには、サプリカントがフィールドデータをキャッシュする必要があります。
EAP_CONFIG_INPUT_FIELD_PROPS_NON_PERSIST
0X00000002
EAP メソッドがフィールドデータをキャッシュしないことを示します。ローミングのためには、サプリカントがフィールドデータをキャッシュする必要があります。
EAP_UI_INPUT_FIELD_PROPS_READ_ONLY
0x00000004
 Windows Vista with SP1 以降: 入力フィールドが読み取り専用であり、編集できないことを示します。
pwszLabelLPWSTR8/4+16+12

入力フィールドのラベルを格納する、ゼロ終端の Unicode 文字列へのポインターです。呼び出し元は、最も内側のポインターから順に、 EapHostPeerFreeMemory 関数を使用して内部のポインターを解放する必要があります。

値 意味
MAX_EAP_CONFIG_INPUT_FIELD_LENGTH
256
 入力フィールドでサポートされる最大長を指定します。
pwszDataLPWSTR8/4+24+16

ユーザーが入力フィールドに入力したデータを格納する、ゼロ終端の Unicode 文字列へのポインターです。この値は初期状態では空です。シングルサインオン (SSO) のシナリオで設定され、EapHostPeerQueryUserBlobFromCredentialInputFields の呼び出しによって EAPHost に返されます。呼び出し元は、最も内側のポインターから順に、 EapHostPeerFreeMemory 関数を使用して内部のポインターを解放する必要があります。

値 意味
MAX_EAP_CONFIG_INPUT_FIELD_VALUE_LENGTH
1024
 入力フィールドでサポートされる最大長を指定します。
dwMinDataLengthDWORD4+32+20EAP 構成ダイアログボックスの入力フィールドにユーザーが入力するデータに許可される最小長 (バイト単位) です。
dwMaxDataLengthDWORD4+36+24EAP 構成ダイアログボックスの入力フィールドにユーザーが入力するデータに許可される最大長 (バイト単位) です。

公式ドキュメント

EAP_CONFIG_INPUT_FIELD_DATA 構造体は、単一の入力フィールドに関連付けられたデータを格納します。

解説(Remarks)

EAP_CONFIG_INPUT_FIELD_DATA 構造体は、SSO をサポートするために使用できます。

この構造体は、EAP 構成ダイアログボックス内の単一の入力フィールドに関連付けられたデータを表します。たとえば、EAP アプリケーションのユーザーが指定した「Login User」のデータを格納できます。

EAP 構成ダイアログボックス内の入力フィールドのコレクション全体は、EAP_CONFIG_INPUT_FIELD_ARRAY 構造体によって表されます。

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

各言語での定義

#include <windows.h>

// EAP_CONFIG_INPUT_FIELD_DATA  (x64 40 / x86 28 バイト)
typedef struct EAP_CONFIG_INPUT_FIELD_DATA {
    DWORD dwSize;
    EAP_CONFIG_INPUT_FIELD_TYPE Type;
    DWORD dwFlagProps;
    LPWSTR pwszLabel;
    LPWSTR pwszData;
    DWORD dwMinDataLength;
    DWORD dwMaxDataLength;
} EAP_CONFIG_INPUT_FIELD_DATA;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct EAP_CONFIG_INPUT_FIELD_DATA
{
    public uint dwSize;
    public int Type;
    public uint dwFlagProps;
    public IntPtr pwszLabel;
    public IntPtr pwszData;
    public uint dwMinDataLength;
    public uint dwMaxDataLength;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure EAP_CONFIG_INPUT_FIELD_DATA
    Public dwSize As UInteger
    Public Type As Integer
    Public dwFlagProps As UInteger
    Public pwszLabel As IntPtr
    Public pwszData As IntPtr
    Public dwMinDataLength As UInteger
    Public dwMaxDataLength As UInteger
End Structure
import ctypes
from ctypes import wintypes

class EAP_CONFIG_INPUT_FIELD_DATA(ctypes.Structure):
    _fields_ = [
        ("dwSize", wintypes.DWORD),
        ("Type", ctypes.c_int),
        ("dwFlagProps", wintypes.DWORD),
        ("pwszLabel", ctypes.c_void_p),
        ("pwszData", ctypes.c_void_p),
        ("dwMinDataLength", wintypes.DWORD),
        ("dwMaxDataLength", wintypes.DWORD),
    ]
#[repr(C)]
pub struct EAP_CONFIG_INPUT_FIELD_DATA {
    pub dwSize: u32,
    pub Type: i32,
    pub dwFlagProps: u32,
    pub pwszLabel: *mut core::ffi::c_void,
    pub pwszData: *mut core::ffi::c_void,
    pub dwMinDataLength: u32,
    pub dwMaxDataLength: u32,
}
import "golang.org/x/sys/windows"

type EAP_CONFIG_INPUT_FIELD_DATA struct {
	dwSize uint32
	Type int32
	dwFlagProps uint32
	pwszLabel uintptr
	pwszData uintptr
	dwMinDataLength uint32
	dwMaxDataLength uint32
}
type
  EAP_CONFIG_INPUT_FIELD_DATA = record
    dwSize: DWORD;
    Type: Integer;
    dwFlagProps: DWORD;
    pwszLabel: Pointer;
    pwszData: Pointer;
    dwMinDataLength: DWORD;
    dwMaxDataLength: DWORD;
  end;
const EAP_CONFIG_INPUT_FIELD_DATA = extern struct {
    dwSize: u32,
    Type: i32,
    dwFlagProps: u32,
    pwszLabel: ?*anyopaque,
    pwszData: ?*anyopaque,
    dwMinDataLength: u32,
    dwMaxDataLength: u32,
};
type
  EAP_CONFIG_INPUT_FIELD_DATA {.bycopy.} = object
    dwSize: uint32
    Type: int32
    dwFlagProps: uint32
    pwszLabel: pointer
    pwszData: pointer
    dwMinDataLength: uint32
    dwMaxDataLength: uint32
struct EAP_CONFIG_INPUT_FIELD_DATA
{
    uint dwSize;
    int Type;
    uint dwFlagProps;
    void* pwszLabel;
    void* pwszData;
    uint dwMinDataLength;
    uint dwMaxDataLength;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; EAP_CONFIG_INPUT_FIELD_DATA サイズ: 28 バイト(x86)
dim st, 7    ; 4byte整数×7(構造体サイズ 28 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Type : EAP_CONFIG_INPUT_FIELD_TYPE (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; dwFlagProps : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; pwszLabel : LPWSTR (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; pwszData : LPWSTR (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; dwMinDataLength : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; dwMaxDataLength : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; EAP_CONFIG_INPUT_FIELD_DATA サイズ: 40 バイト(x64)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Type : EAP_CONFIG_INPUT_FIELD_TYPE (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; dwFlagProps : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; pwszLabel : LPWSTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; pwszData : LPWSTR (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; dwMinDataLength : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; dwMaxDataLength : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global EAP_CONFIG_INPUT_FIELD_DATA
    #field int dwSize
    #field int Type
    #field int dwFlagProps
    #field intptr pwszLabel
    #field intptr pwszData
    #field int dwMinDataLength
    #field int dwMaxDataLength
#endstruct

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