ホーム › Security.Tpm › ITpmVirtualSmartCardManager

ITpmVirtualSmartCardManager

COM

IID112b1dff-d9dc-41f7-869f-d67fee7cb591継承元IUnknown自前メソッド開始 vtbl3

メソッド 2

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT CreateVirtualSmartCard(LPWSTR pszFriendlyName, BYTE bAdminAlgId, BYTE* pbAdminKey, DWORD cbAdminKey, BYTE* pbAdminKcv, DWORD cbAdminKcv, BYTE* pbPuk, DWORD cbPuk, BYTE* pbPin, DWORD cbPin, BOOL fGenerate, ITpmVirtualSmartCardManagerStatusCallback* pStatusCallback, LPWSTR* ppszInstanceId, BOOL* pfNeedReboot)

pszFriendlyName	LPWSTR	in	作成する仮想スマートカードの分かりやすい表示名を渡す。
bAdminAlgId	BYTE	in	管理者キーに使用する暗号化アルゴリズムの ID(BYTE)を渡す。
pbAdminKey	BYTE*	in	管理者キーのバイト配列を渡す。
cbAdminKey	DWORD	in	pbAdminKey が指す管理者キーのバイト数を指定する。
pbAdminKcv	BYTE*	in	管理者キーのキー検証値(KCV)のバイト配列を渡す。
cbAdminKcv	DWORD	in	pbAdminKcv が指すキー検証値のバイト数を指定する。
pbPuk	BYTE*	in	PUK(PIN ロック解除キー)のバイト配列を渡す。設定しない場合は NULL を指定する。
cbPuk	DWORD	in	pbPuk が指す PUK のバイト数を指定する。
pbPin	BYTE*	in	ユーザー PIN のバイト配列を渡す。
cbPin	DWORD	in	pbPin が指す PIN のバイト数を指定する。
fGenerate	BOOL	in	管理者キーをデバイス側で新規生成するかどうかを指定する BOOL 値を渡す。
pStatusCallback	ITpmVirtualSmartCardManagerStatusCallback*	in	処理の進行状況やエラーを受け取るコールバックインターフェイスへのポインタを渡す。不要な場合は NULL を指定する。
ppszInstanceId	LPWSTR*	out	作成された仮想スマートカードのインスタンス ID を受け取る LPWSTR へのポインタである。
pfNeedReboot	BOOL*	out	操作を完了するために再起動が必要かどうかを受け取る BOOL へのポインタである。

vtbl 4 HRESULT DestroyVirtualSmartCard(LPWSTR pszInstanceId, ITpmVirtualSmartCardManagerStatusCallback* pStatusCallback, BOOL* pfNeedReboot)

pszInstanceId	LPWSTR	in	破棄する仮想スマートカードのインスタンス ID を渡す。
pStatusCallback	ITpmVirtualSmartCardManagerStatusCallback*	in	処理の進行状況やエラーを受け取るコールバックインターフェイスへのポインタを渡す。不要な場合は NULL を指定する。
pfNeedReboot	BOOL*	out	操作を完了するために再起動が必要かどうかを受け取る BOOL へのポインタである。

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数:

#define global IID_ITpmVirtualSmartCardManager "{112B1DFF-D9DC-41F7-869F-D67FEE7CB591}"
#usecom global ITpmVirtualSmartCardManager IID_ITpmVirtualSmartCardManager "{16A18E86-7F6E-4C20-AD89-4FFC0DB7A96A}"
#comfunc global ITpmVirtualSmartCardManager_CreateVirtualSmartCard   3 wstr,int,var,int,var,int,var,int,var,int,int,sptr,var,var
#comfunc global ITpmVirtualSmartCardManager_DestroyVirtualSmartCard  4 wstr,sptr,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_ITpmVirtualSmartCardManager "{112B1DFF-D9DC-41F7-869F-D67FEE7CB591}"
#usecom global ITpmVirtualSmartCardManager IID_ITpmVirtualSmartCardManager "{16A18E86-7F6E-4C20-AD89-4FFC0DB7A96A}"
#comfunc global ITpmVirtualSmartCardManager_CreateVirtualSmartCard   3 wstr,int,sptr,int,sptr,int,sptr,int,sptr,int,int,sptr,sptr,sptr
#comfunc global ITpmVirtualSmartCardManager_DestroyVirtualSmartCard  4 wstr,sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。