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

OPENCARDNAMEW

構造体
サイズx64: 176 バイト / x86: 92 バイト

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

フィールド

フィールドサイズx64x86説明
dwStructSizeDWORD4+0+0構造体の長さをバイト単位で指定します。このメンバーは NULL であってはなりません。
hwndOwnerHWND8/4+8+4ダイアログ ボックスを所有するウィンドウです。このメンバーには任意の有効なウィンドウ ハンドルを指定できます。既定のデスクトップを使用する場合は NULL を指定できます。
hSCardContextUINT_PTR8/4+16+8スマート カード リソース マネージャー との通信に使用するコンテキストです。 SCardEstablishContext を呼び出して リソース マネージャー コンテキスト を設定し、 SCardReleaseContext を呼び出して解放します。このメンバーは NULL であってはなりません。
lpstrGroupNamesLPWSTR8/4+24+12null で終わるグループ名文字列を格納するバッファーへのポインターです。バッファー内の最後の文字列は、2 つの null 文字で終端する必要があります。各文字列は、検索対象に含めるカードのグループの名前です。lpstrGroupNamesNULL の場合は、既定のグループ (Scard$DefaultReaders) が検索されます。
nMaxGroupNamesDWORD4+32+16lpstrGroupNames 文字列の最大バイト数 (ANSI 版) または最大文字数 (Unicode 版) です。
lpstrCardNamesLPWSTR8/4+40+20null で終わるカード名文字列を格納するバッファーへのポインターです。バッファー内の最後の文字列は、2 つの null 文字で終端する必要があります。各文字列は、検索対象となるカードの名前です。
nMaxCardNamesDWORD4+48+24lpstrCardNames 文字列の最大バイト数 (ANSI 版) または最大文字数 (Unicode 版) です。
rgguidInterfacesGUID*8/4+56+28将来の使用のために予約済みです。NULL を設定してください。必要なインターフェイスを識別する GUID の配列です。
cguidInterfacesDWORD4+64+32将来の使用のために予約済みです。NULL を設定してください。rgguidInterfaces 配列内のインターフェイスの数です。
lpstrRdrLPWSTR8/4+72+36カードが見つかった場合、lpstrRdr バッファーには、そのカードが挿入されているリーダーの名前が格納されます。バッファーは 256 文字以上の長さが必要です。
nMaxRdrDWORD4+80+40lpstrRdr が指すバッファーのサイズ (バイト単位 (ANSI 版) または文字単位 (Unicode 版)) です。バッファーが小さすぎてリーダー情報を格納できない場合、 GetOpenCardNameSCARD_E_NO_MEMORY と、lpstrRdr が指すバッファーに必要なサイズを返します。
lpstrCardLPWSTR8/4+88+44カードが見つかった場合、lpstrCard バッファーには、見つかったカードの名前が格納されます。バッファーは 256 文字以上の長さが必要です。
nMaxCardDWORD4+96+48lpstrCard が指すバッファーのサイズ (バイト単位 (ANSI 版) または文字単位 (Unicode 版)) です。バッファーが小さすぎてカード情報を格納できない場合、GetOpenCardNameSCARD_E_NO_MEMORY を返し、必要なバッファーのサイズを nMaxCard に返します。
lpstrTitleLPWSTR8/4+104+52ダイアログ ボックスのタイトル バーに表示する文字列へのポインターです。このメンバーが NULL の場合、システムは既定のタイトル "Select Card:" を使用します。
dwFlagsDWORD4+112+56

ダイアログ ボックスの初期化に使用できるビット フラグのセットです。ダイアログ ボックスから制御が戻るとき、これらのフラグにはユーザーの入力を示す値が設定されます。このメンバーには、次のフラグの組み合わせを指定できます。

意味
SC_DLG_MINIMAL_UI
呼び出し元アプリケーションが検索しているカードが見つからず、リーダー内で使用できない場合にのみ、ダイアログ ボックスを表示します。これにより、カードを検索し、(内部のダイアログ ボックス機構またはユーザー コールバック関数を通じて) 接続して、呼び出し元アプリケーションに返すことができます。
SC_DLG_NO_UI
検索結果にかかわらず、Select Card ユーザー インターフェイス (UI) を表示しないように強制します。
SC_DLG_FORCE_UI
検索結果にかかわらず、Select Card UI を強制的に表示します。
pvUserDatavoid*8/4+120+60ユーザー データへの void ポインターです。このポインターは、Connect、Check、Disconnect の各ルーチンで呼び出し元に渡されます。
dwShareModeDWORD4+128+64

lpfnConnectNULL でない場合、dwShareMode メンバーと dwPreferredProtocols メンバーは無視されます。

lpfnConnectNULL で、かつ dwShareMode が 0 以外の場合は、dwShareModedwPreferredProtocolsdwShareMode パラメーターおよび dwPreferredProtocols パラメーターとして使用して、 SCardConnect が内部的に呼び出されます。接続に成功すると、hCardHandle には hSCardConnect が返したハンドルが設定されます。

lpfnConnectNULL で、かつ dwShareMode が 0 の場合、ダイアログ ボックスは hCardHandle として NULL を返します。

dwPreferredProtocolsDWORD4+132+68dwShareMode の説明にあるとおり、内部的な接続に使用されます。
dwActiveProtocolDWORD4+136+72ダイアログ ボックスがカードに接続したときに、実際に使用されているプロトコルを返します。
lpfnConnectLPOCNCONNPROCW8/4+144+76

呼び出し元のカード接続ルーチンへのポインターです。カードへの接続に追加の処理が必要な場合は、この関数ポインターにユーザーの接続関数を設定します。接続関数が成功した場合、カードは接続および初期化された状態のまま維持され、カード ハンドルが返されます。

接続ルーチンのプロトタイプは次のとおりです。

Connect(
  hSCardContext, // the card context passed in the parameter block
  szReader,      // the name of the reader
  mszCards,      // multiple string that contains the 
                 //    possible card names in the reader
  pvUserData     // pointer to user data passed in parameter block
);
lpfnCheckLPOCNCHKPROC8/4+152+80

呼び出し元のカード検証ルーチンへのポインターです。特別なカード検証が不要な場合、このポインターは NULL になります。

検証ルーチンによってカードが拒否された場合は FALSE が返され、lpfnDisconnect で示されるルーチンによってカードは切断されます。

検証ルーチンによってカードが受け入れられた場合は TRUE が返されます。ユーザーがカードを受け入れると、現在接続されている他のすべてのカードは lpfnDisconnect で示されるルーチンによって切断され、このカードが検出されたカードとして返されます。検出されたカードは接続されたままとなります。

チェック ルーチンのプロトタイプは次のとおりです。

Check(
  hSCardContext, // the card context passed in the parameter block
  hCard,         // card handle
  pvUserData     // pointer to user data passed in the parameter block
);
lpfnDisconnectLPOCNDSCPROC8/4+160+84

呼び出し元のカード切断ルーチンへのポインターです。

切断ルーチンのプロトタイプは次のとおりです。

Disconnect(
  hSCardContext, // the card context passed in the parameter block
  hCard,         // card handle
  pvUserData     // pointer to user data passed in the parameter block
);
lpfnConnectlpfnChecklpfnDisconnect を使用する場合は、これら 3 つのコールバック プロシージャをすべて用意する必要があります。これらのコールバックを使用すると、呼び出し元アプリケーションが適切なカードを見つけたことをさらに検証できます。これは、適切なカードが選択されていることを確認する最良の方法です。
hCardHandleUINT_PTR8/4+168+88接続されたカードのハンドルです (内部のダイアログ ボックスによる接続、または lpfnConnect コールバックのいずれかによるもの)。

公式ドキュメント

OPENCARDNAME 構造体は、 GetOpenCardName 関数がスマート カードの Select Card ダイアログ ボックスを初期化するために使用する情報を格納します。OPENCARDNAME を指定して GetOpenCardName を呼び出すよりも、OPENCARDNAME_EX を指定して SCardUIDlgSelectCard を呼び出すことを推奨します。OPENCARDNAME は下位互換性のために提供されています。

解説(Remarks)

メモ

winscard.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして OPENCARDNAME を定義します。エンコードに依存しないエイリアスの使用と、エンコードに依存するコードを混在させると、不一致が生じ、コンパイル エラーまたは実行時エラーの原因となる場合があります。詳細については、関数プロトタイプの規則 を参照してください。

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

各言語での定義

#include <windows.h>

// OPENCARDNAMEW  (x64 176 / x86 92 バイト)
typedef struct OPENCARDNAMEW {
    DWORD dwStructSize;
    HWND hwndOwner;
    UINT_PTR hSCardContext;
    LPWSTR lpstrGroupNames;
    DWORD nMaxGroupNames;
    LPWSTR lpstrCardNames;
    DWORD nMaxCardNames;
    GUID* rgguidInterfaces;
    DWORD cguidInterfaces;
    LPWSTR lpstrRdr;
    DWORD nMaxRdr;
    LPWSTR lpstrCard;
    DWORD nMaxCard;
    LPWSTR lpstrTitle;
    DWORD dwFlags;
    void* pvUserData;
    DWORD dwShareMode;
    DWORD dwPreferredProtocols;
    DWORD dwActiveProtocol;
    LPOCNCONNPROCW lpfnConnect;
    LPOCNCHKPROC lpfnCheck;
    LPOCNDSCPROC lpfnDisconnect;
    UINT_PTR hCardHandle;
} OPENCARDNAMEW;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct OPENCARDNAMEW
{
    public uint dwStructSize;
    public IntPtr hwndOwner;
    public UIntPtr hSCardContext;
    public IntPtr lpstrGroupNames;
    public uint nMaxGroupNames;
    public IntPtr lpstrCardNames;
    public uint nMaxCardNames;
    public IntPtr rgguidInterfaces;
    public uint cguidInterfaces;
    public IntPtr lpstrRdr;
    public uint nMaxRdr;
    public IntPtr lpstrCard;
    public uint nMaxCard;
    public IntPtr lpstrTitle;
    public uint dwFlags;
    public IntPtr pvUserData;
    public uint dwShareMode;
    public uint dwPreferredProtocols;
    public uint dwActiveProtocol;
    public IntPtr lpfnConnect;
    public IntPtr lpfnCheck;
    public IntPtr lpfnDisconnect;
    public UIntPtr hCardHandle;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure OPENCARDNAMEW
    Public dwStructSize As UInteger
    Public hwndOwner As IntPtr
    Public hSCardContext As UIntPtr
    Public lpstrGroupNames As IntPtr
    Public nMaxGroupNames As UInteger
    Public lpstrCardNames As IntPtr
    Public nMaxCardNames As UInteger
    Public rgguidInterfaces As IntPtr
    Public cguidInterfaces As UInteger
    Public lpstrRdr As IntPtr
    Public nMaxRdr As UInteger
    Public lpstrCard As IntPtr
    Public nMaxCard As UInteger
    Public lpstrTitle As IntPtr
    Public dwFlags As UInteger
    Public pvUserData As IntPtr
    Public dwShareMode As UInteger
    Public dwPreferredProtocols As UInteger
    Public dwActiveProtocol As UInteger
    Public lpfnConnect As IntPtr
    Public lpfnCheck As IntPtr
    Public lpfnDisconnect As IntPtr
    Public hCardHandle As UIntPtr
End Structure
import ctypes
from ctypes import wintypes

class OPENCARDNAMEW(ctypes.Structure):
    _fields_ = [
        ("dwStructSize", wintypes.DWORD),
        ("hwndOwner", ctypes.c_void_p),
        ("hSCardContext", ctypes.c_size_t),
        ("lpstrGroupNames", ctypes.c_void_p),
        ("nMaxGroupNames", wintypes.DWORD),
        ("lpstrCardNames", ctypes.c_void_p),
        ("nMaxCardNames", wintypes.DWORD),
        ("rgguidInterfaces", ctypes.c_void_p),
        ("cguidInterfaces", wintypes.DWORD),
        ("lpstrRdr", ctypes.c_void_p),
        ("nMaxRdr", wintypes.DWORD),
        ("lpstrCard", ctypes.c_void_p),
        ("nMaxCard", wintypes.DWORD),
        ("lpstrTitle", ctypes.c_void_p),
        ("dwFlags", wintypes.DWORD),
        ("pvUserData", ctypes.c_void_p),
        ("dwShareMode", wintypes.DWORD),
        ("dwPreferredProtocols", wintypes.DWORD),
        ("dwActiveProtocol", wintypes.DWORD),
        ("lpfnConnect", ctypes.c_void_p),
        ("lpfnCheck", ctypes.c_void_p),
        ("lpfnDisconnect", ctypes.c_void_p),
        ("hCardHandle", ctypes.c_size_t),
    ]
#[repr(C)]
pub struct OPENCARDNAMEW {
    pub dwStructSize: u32,
    pub hwndOwner: *mut core::ffi::c_void,
    pub hSCardContext: usize,
    pub lpstrGroupNames: *mut core::ffi::c_void,
    pub nMaxGroupNames: u32,
    pub lpstrCardNames: *mut core::ffi::c_void,
    pub nMaxCardNames: u32,
    pub rgguidInterfaces: *mut core::ffi::c_void,
    pub cguidInterfaces: u32,
    pub lpstrRdr: *mut core::ffi::c_void,
    pub nMaxRdr: u32,
    pub lpstrCard: *mut core::ffi::c_void,
    pub nMaxCard: u32,
    pub lpstrTitle: *mut core::ffi::c_void,
    pub dwFlags: u32,
    pub pvUserData: *mut core::ffi::c_void,
    pub dwShareMode: u32,
    pub dwPreferredProtocols: u32,
    pub dwActiveProtocol: u32,
    pub lpfnConnect: *mut core::ffi::c_void,
    pub lpfnCheck: *mut core::ffi::c_void,
    pub lpfnDisconnect: *mut core::ffi::c_void,
    pub hCardHandle: usize,
}
import "golang.org/x/sys/windows"

type OPENCARDNAMEW struct {
	dwStructSize uint32
	hwndOwner uintptr
	hSCardContext uintptr
	lpstrGroupNames uintptr
	nMaxGroupNames uint32
	lpstrCardNames uintptr
	nMaxCardNames uint32
	rgguidInterfaces uintptr
	cguidInterfaces uint32
	lpstrRdr uintptr
	nMaxRdr uint32
	lpstrCard uintptr
	nMaxCard uint32
	lpstrTitle uintptr
	dwFlags uint32
	pvUserData uintptr
	dwShareMode uint32
	dwPreferredProtocols uint32
	dwActiveProtocol uint32
	lpfnConnect uintptr
	lpfnCheck uintptr
	lpfnDisconnect uintptr
	hCardHandle uintptr
}
type
  OPENCARDNAMEW = record
    dwStructSize: DWORD;
    hwndOwner: Pointer;
    hSCardContext: NativeUInt;
    lpstrGroupNames: Pointer;
    nMaxGroupNames: DWORD;
    lpstrCardNames: Pointer;
    nMaxCardNames: DWORD;
    rgguidInterfaces: Pointer;
    cguidInterfaces: DWORD;
    lpstrRdr: Pointer;
    nMaxRdr: DWORD;
    lpstrCard: Pointer;
    nMaxCard: DWORD;
    lpstrTitle: Pointer;
    dwFlags: DWORD;
    pvUserData: Pointer;
    dwShareMode: DWORD;
    dwPreferredProtocols: DWORD;
    dwActiveProtocol: DWORD;
    lpfnConnect: Pointer;
    lpfnCheck: Pointer;
    lpfnDisconnect: Pointer;
    hCardHandle: NativeUInt;
  end;
const OPENCARDNAMEW = extern struct {
    dwStructSize: u32,
    hwndOwner: ?*anyopaque,
    hSCardContext: usize,
    lpstrGroupNames: ?*anyopaque,
    nMaxGroupNames: u32,
    lpstrCardNames: ?*anyopaque,
    nMaxCardNames: u32,
    rgguidInterfaces: ?*anyopaque,
    cguidInterfaces: u32,
    lpstrRdr: ?*anyopaque,
    nMaxRdr: u32,
    lpstrCard: ?*anyopaque,
    nMaxCard: u32,
    lpstrTitle: ?*anyopaque,
    dwFlags: u32,
    pvUserData: ?*anyopaque,
    dwShareMode: u32,
    dwPreferredProtocols: u32,
    dwActiveProtocol: u32,
    lpfnConnect: ?*anyopaque,
    lpfnCheck: ?*anyopaque,
    lpfnDisconnect: ?*anyopaque,
    hCardHandle: usize,
};
type
  OPENCARDNAMEW {.bycopy.} = object
    dwStructSize: uint32
    hwndOwner: pointer
    hSCardContext: uint
    lpstrGroupNames: pointer
    nMaxGroupNames: uint32
    lpstrCardNames: pointer
    nMaxCardNames: uint32
    rgguidInterfaces: pointer
    cguidInterfaces: uint32
    lpstrRdr: pointer
    nMaxRdr: uint32
    lpstrCard: pointer
    nMaxCard: uint32
    lpstrTitle: pointer
    dwFlags: uint32
    pvUserData: pointer
    dwShareMode: uint32
    dwPreferredProtocols: uint32
    dwActiveProtocol: uint32
    lpfnConnect: pointer
    lpfnCheck: pointer
    lpfnDisconnect: pointer
    hCardHandle: uint
struct OPENCARDNAMEW
{
    uint dwStructSize;
    void* hwndOwner;
    size_t hSCardContext;
    void* lpstrGroupNames;
    uint nMaxGroupNames;
    void* lpstrCardNames;
    uint nMaxCardNames;
    void* rgguidInterfaces;
    uint cguidInterfaces;
    void* lpstrRdr;
    uint nMaxRdr;
    void* lpstrCard;
    uint nMaxCard;
    void* lpstrTitle;
    uint dwFlags;
    void* pvUserData;
    uint dwShareMode;
    uint dwPreferredProtocols;
    uint dwActiveProtocol;
    void* lpfnConnect;
    void* lpfnCheck;
    void* lpfnDisconnect;
    size_t hCardHandle;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; OPENCARDNAMEW サイズ: 92 バイト(x86)
dim st, 23    ; 4byte整数×23(構造体サイズ 92 / 4 切り上げ)
; dwStructSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; hwndOwner : HWND (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; hSCardContext : UINT_PTR (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; lpstrGroupNames : LPWSTR (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; nMaxGroupNames : 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 も可)
; rgguidInterfaces : GUID* (+28, 4byte)  varptr(st)+28 を基点に操作(4byte:入れ子/配列)
; cguidInterfaces : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; lpstrRdr : LPWSTR (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; nMaxRdr : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; lpstrCard : LPWSTR (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; nMaxCard : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; lpstrTitle : LPWSTR (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; dwFlags : DWORD (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; pvUserData : void* (+60, 4byte)  st.15 = 値  /  値 = st.15   (lpoke/lpeek も可)
; dwShareMode : DWORD (+64, 4byte)  st.16 = 値  /  値 = st.16   (lpoke/lpeek も可)
; dwPreferredProtocols : DWORD (+68, 4byte)  st.17 = 値  /  値 = st.17   (lpoke/lpeek も可)
; dwActiveProtocol : DWORD (+72, 4byte)  st.18 = 値  /  値 = st.18   (lpoke/lpeek も可)
; lpfnConnect : LPOCNCONNPROCW (+76, 4byte)  st.19 = 値  /  値 = st.19   (lpoke/lpeek も可)
; lpfnCheck : LPOCNCHKPROC (+80, 4byte)  st.20 = 値  /  値 = st.20   (lpoke/lpeek も可)
; lpfnDisconnect : LPOCNDSCPROC (+84, 4byte)  st.21 = 値  /  値 = st.21   (lpoke/lpeek も可)
; hCardHandle : UINT_PTR (+88, 4byte)  st.22 = 値  /  値 = st.22   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; OPENCARDNAMEW サイズ: 176 バイト(x64)
dim st, 44    ; 4byte整数×44(構造体サイズ 176 / 4 切り上げ)
; dwStructSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; hwndOwner : HWND (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; hSCardContext : UINT_PTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; lpstrGroupNames : LPWSTR (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; nMaxGroupNames : 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 も可)
; rgguidInterfaces : GUID* (+56, 8byte)  varptr(st)+56 を基点に操作(8byte:入れ子/配列)
; cguidInterfaces : DWORD (+64, 4byte)  st.16 = 値  /  値 = st.16   (lpoke/lpeek も可)
; lpstrRdr : LPWSTR (+72, 8byte)  qpoke st,72,値 / qpeek(st,72)  ※IronHSPのみ。3.7/3.8は lpoke st,72,下位 : lpoke st,76,上位
; nMaxRdr : DWORD (+80, 4byte)  st.20 = 値  /  値 = st.20   (lpoke/lpeek も可)
; lpstrCard : LPWSTR (+88, 8byte)  qpoke st,88,値 / qpeek(st,88)  ※IronHSPのみ。3.7/3.8は lpoke st,88,下位 : lpoke st,92,上位
; nMaxCard : DWORD (+96, 4byte)  st.24 = 値  /  値 = st.24   (lpoke/lpeek も可)
; lpstrTitle : LPWSTR (+104, 8byte)  qpoke st,104,値 / qpeek(st,104)  ※IronHSPのみ。3.7/3.8は lpoke st,104,下位 : lpoke st,108,上位
; dwFlags : DWORD (+112, 4byte)  st.28 = 値  /  値 = st.28   (lpoke/lpeek も可)
; pvUserData : void* (+120, 8byte)  qpoke st,120,値 / qpeek(st,120)  ※IronHSPのみ。3.7/3.8は lpoke st,120,下位 : lpoke st,124,上位
; dwShareMode : DWORD (+128, 4byte)  st.32 = 値  /  値 = st.32   (lpoke/lpeek も可)
; dwPreferredProtocols : DWORD (+132, 4byte)  st.33 = 値  /  値 = st.33   (lpoke/lpeek も可)
; dwActiveProtocol : DWORD (+136, 4byte)  st.34 = 値  /  値 = st.34   (lpoke/lpeek も可)
; lpfnConnect : LPOCNCONNPROCW (+144, 8byte)  qpoke st,144,値 / qpeek(st,144)  ※IronHSPのみ。3.7/3.8は lpoke st,144,下位 : lpoke st,148,上位
; lpfnCheck : LPOCNCHKPROC (+152, 8byte)  qpoke st,152,値 / qpeek(st,152)  ※IronHSPのみ。3.7/3.8は lpoke st,152,下位 : lpoke st,156,上位
; lpfnDisconnect : LPOCNDSCPROC (+160, 8byte)  qpoke st,160,値 / qpeek(st,160)  ※IronHSPのみ。3.7/3.8は lpoke st,160,下位 : lpoke st,164,上位
; hCardHandle : UINT_PTR (+168, 8byte)  qpoke st,168,値 / qpeek(st,168)  ※IronHSPのみ。3.7/3.8は lpoke st,168,下位 : lpoke st,172,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global OPENCARDNAMEW
    #field int dwStructSize
    #field intptr hwndOwner
    #field intptr hSCardContext
    #field intptr lpstrGroupNames
    #field int nMaxGroupNames
    #field intptr lpstrCardNames
    #field int nMaxCardNames
    #field intptr rgguidInterfaces
    #field int cguidInterfaces
    #field intptr lpstrRdr
    #field int nMaxRdr
    #field intptr lpstrCard
    #field int nMaxCard
    #field intptr lpstrTitle
    #field int dwFlags
    #field intptr pvUserData
    #field int dwShareMode
    #field int dwPreferredProtocols
    #field int dwActiveProtocol
    #field intptr lpfnConnect
    #field intptr lpfnCheck
    #field intptr lpfnDisconnect
    #field intptr hCardHandle
#endstruct

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