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

OPENCARD_SEARCH_CRITERIAW

構造体
サイズx64: 96 バイト / x86: 52 バイト

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

フィールド

フィールドサイズx64x86説明
dwStructSizeDWORD4+0+0この構造体のバイトサイズ。
lpstrGroupNamesLPWSTR8/4+8+4検索対象とするリーダーグループ名(複数はNUL区切り)(Unicode)。
nMaxGroupNamesDWORD4+16+8lpstrGroupNamesバッファの文字数。
rgguidInterfacesGUID*8/4+24+12カードが備えるべきインターフェイスGUIDの配列。
cguidInterfacesDWORD4+32+16rgguidInterfaces配列の要素数。
lpstrCardNamesLPWSTR8/4+40+20検索対象とするカード名(複数はNUL区切り)(Unicode)。
nMaxCardNamesDWORD4+48+24lpstrCardNamesバッファの文字数。
lpfnCheckLPOCNCHKPROC8/4+56+28カードが条件を満たすか確認するコールバック関数。NULL可。
lpfnConnectLPOCNCONNPROCW8/4+64+32カードへ接続するコールバック関数(Unicode)。NULL可。
lpfnDisconnectLPOCNDSCPROC8/4+72+36カードを切断するコールバック関数。NULL可。
pvUserDatavoid*8/4+80+40コールバックに渡すユーザーデータへのポインタ。
dwShareModeDWORD4+88+44カードへの共有アクセスモード。
dwPreferredProtocolsDWORD4+92+48優先する通信プロトコルのビットマスク。

各言語での定義

#include <windows.h>

// OPENCARD_SEARCH_CRITERIAW  (x64 96 / x86 52 バイト)
typedef struct OPENCARD_SEARCH_CRITERIAW {
    DWORD dwStructSize;
    LPWSTR lpstrGroupNames;
    DWORD nMaxGroupNames;
    GUID* rgguidInterfaces;
    DWORD cguidInterfaces;
    LPWSTR lpstrCardNames;
    DWORD nMaxCardNames;
    LPOCNCHKPROC lpfnCheck;
    LPOCNCONNPROCW lpfnConnect;
    LPOCNDSCPROC lpfnDisconnect;
    void* pvUserData;
    DWORD dwShareMode;
    DWORD dwPreferredProtocols;
} OPENCARD_SEARCH_CRITERIAW;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct OPENCARD_SEARCH_CRITERIAW
{
    public uint dwStructSize;
    public IntPtr lpstrGroupNames;
    public uint nMaxGroupNames;
    public IntPtr rgguidInterfaces;
    public uint cguidInterfaces;
    public IntPtr lpstrCardNames;
    public uint nMaxCardNames;
    public IntPtr lpfnCheck;
    public IntPtr lpfnConnect;
    public IntPtr lpfnDisconnect;
    public IntPtr pvUserData;
    public uint dwShareMode;
    public uint dwPreferredProtocols;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure OPENCARD_SEARCH_CRITERIAW
    Public dwStructSize As UInteger
    Public lpstrGroupNames As IntPtr
    Public nMaxGroupNames As UInteger
    Public rgguidInterfaces As IntPtr
    Public cguidInterfaces As UInteger
    Public lpstrCardNames As IntPtr
    Public nMaxCardNames As UInteger
    Public lpfnCheck As IntPtr
    Public lpfnConnect As IntPtr
    Public lpfnDisconnect As IntPtr
    Public pvUserData As IntPtr
    Public dwShareMode As UInteger
    Public dwPreferredProtocols As UInteger
End Structure
import ctypes
from ctypes import wintypes

class OPENCARD_SEARCH_CRITERIAW(ctypes.Structure):
    _fields_ = [
        ("dwStructSize", wintypes.DWORD),
        ("lpstrGroupNames", ctypes.c_void_p),
        ("nMaxGroupNames", wintypes.DWORD),
        ("rgguidInterfaces", ctypes.c_void_p),
        ("cguidInterfaces", wintypes.DWORD),
        ("lpstrCardNames", ctypes.c_void_p),
        ("nMaxCardNames", wintypes.DWORD),
        ("lpfnCheck", ctypes.c_void_p),
        ("lpfnConnect", ctypes.c_void_p),
        ("lpfnDisconnect", ctypes.c_void_p),
        ("pvUserData", ctypes.c_void_p),
        ("dwShareMode", wintypes.DWORD),
        ("dwPreferredProtocols", wintypes.DWORD),
    ]
#[repr(C)]
pub struct OPENCARD_SEARCH_CRITERIAW {
    pub dwStructSize: u32,
    pub lpstrGroupNames: *mut core::ffi::c_void,
    pub nMaxGroupNames: u32,
    pub rgguidInterfaces: *mut core::ffi::c_void,
    pub cguidInterfaces: u32,
    pub lpstrCardNames: *mut core::ffi::c_void,
    pub nMaxCardNames: u32,
    pub lpfnCheck: *mut core::ffi::c_void,
    pub lpfnConnect: *mut core::ffi::c_void,
    pub lpfnDisconnect: *mut core::ffi::c_void,
    pub pvUserData: *mut core::ffi::c_void,
    pub dwShareMode: u32,
    pub dwPreferredProtocols: u32,
}
import "golang.org/x/sys/windows"

type OPENCARD_SEARCH_CRITERIAW struct {
	dwStructSize uint32
	lpstrGroupNames uintptr
	nMaxGroupNames uint32
	rgguidInterfaces uintptr
	cguidInterfaces uint32
	lpstrCardNames uintptr
	nMaxCardNames uint32
	lpfnCheck uintptr
	lpfnConnect uintptr
	lpfnDisconnect uintptr
	pvUserData uintptr
	dwShareMode uint32
	dwPreferredProtocols uint32
}
type
  OPENCARD_SEARCH_CRITERIAW = record
    dwStructSize: DWORD;
    lpstrGroupNames: Pointer;
    nMaxGroupNames: DWORD;
    rgguidInterfaces: Pointer;
    cguidInterfaces: DWORD;
    lpstrCardNames: Pointer;
    nMaxCardNames: DWORD;
    lpfnCheck: Pointer;
    lpfnConnect: Pointer;
    lpfnDisconnect: Pointer;
    pvUserData: Pointer;
    dwShareMode: DWORD;
    dwPreferredProtocols: DWORD;
  end;
const OPENCARD_SEARCH_CRITERIAW = extern struct {
    dwStructSize: u32,
    lpstrGroupNames: ?*anyopaque,
    nMaxGroupNames: u32,
    rgguidInterfaces: ?*anyopaque,
    cguidInterfaces: u32,
    lpstrCardNames: ?*anyopaque,
    nMaxCardNames: u32,
    lpfnCheck: ?*anyopaque,
    lpfnConnect: ?*anyopaque,
    lpfnDisconnect: ?*anyopaque,
    pvUserData: ?*anyopaque,
    dwShareMode: u32,
    dwPreferredProtocols: u32,
};
type
  OPENCARD_SEARCH_CRITERIAW {.bycopy.} = object
    dwStructSize: uint32
    lpstrGroupNames: pointer
    nMaxGroupNames: uint32
    rgguidInterfaces: pointer
    cguidInterfaces: uint32
    lpstrCardNames: pointer
    nMaxCardNames: uint32
    lpfnCheck: pointer
    lpfnConnect: pointer
    lpfnDisconnect: pointer
    pvUserData: pointer
    dwShareMode: uint32
    dwPreferredProtocols: uint32
struct OPENCARD_SEARCH_CRITERIAW
{
    uint dwStructSize;
    void* lpstrGroupNames;
    uint nMaxGroupNames;
    void* rgguidInterfaces;
    uint cguidInterfaces;
    void* lpstrCardNames;
    uint nMaxCardNames;
    void* lpfnCheck;
    void* lpfnConnect;
    void* lpfnDisconnect;
    void* pvUserData;
    uint dwShareMode;
    uint dwPreferredProtocols;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; OPENCARD_SEARCH_CRITERIAW サイズ: 52 バイト(x86)
dim st, 13    ; 4byte整数×13(構造体サイズ 52 / 4 切り上げ)
; dwStructSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; lpstrGroupNames : LPWSTR (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; nMaxGroupNames : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; rgguidInterfaces : GUID* (+12, 4byte)  varptr(st)+12 を基点に操作(4byte:入れ子/配列)
; cguidInterfaces : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; lpstrCardNames : LPWSTR (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; nMaxCardNames : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; lpfnCheck : LPOCNCHKPROC (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; lpfnConnect : LPOCNCONNPROCW (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; lpfnDisconnect : LPOCNDSCPROC (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; pvUserData : void* (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; dwShareMode : DWORD (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; dwPreferredProtocols : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; OPENCARD_SEARCH_CRITERIAW サイズ: 96 バイト(x64)
dim st, 24    ; 4byte整数×24(構造体サイズ 96 / 4 切り上げ)
; dwStructSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; lpstrGroupNames : LPWSTR (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; nMaxGroupNames : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; rgguidInterfaces : GUID* (+24, 8byte)  varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; cguidInterfaces : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; lpstrCardNames : LPWSTR (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; nMaxCardNames : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; lpfnCheck : LPOCNCHKPROC (+56, 8byte)  qpoke st,56,値 / qpeek(st,56)  ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; lpfnConnect : LPOCNCONNPROCW (+64, 8byte)  qpoke st,64,値 / qpeek(st,64)  ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; lpfnDisconnect : LPOCNDSCPROC (+72, 8byte)  qpoke st,72,値 / qpeek(st,72)  ※IronHSPのみ。3.7/3.8は lpoke st,72,下位 : lpoke st,76,上位
; pvUserData : void* (+80, 8byte)  qpoke st,80,値 / qpeek(st,80)  ※IronHSPのみ。3.7/3.8は lpoke st,80,下位 : lpoke st,84,上位
; dwShareMode : DWORD (+88, 4byte)  st.22 = 値  /  値 = st.22   (lpoke/lpeek も可)
; dwPreferredProtocols : DWORD (+92, 4byte)  st.23 = 値  /  値 = st.23   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global OPENCARD_SEARCH_CRITERIAW
    #field int dwStructSize
    #field intptr lpstrGroupNames
    #field int nMaxGroupNames
    #field intptr rgguidInterfaces
    #field int cguidInterfaces
    #field intptr lpstrCardNames
    #field int nMaxCardNames
    #field intptr lpfnCheck
    #field intptr lpfnConnect
    #field intptr lpfnDisconnect
    #field intptr pvUserData
    #field int dwShareMode
    #field int dwPreferredProtocols
#endstruct

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