Win32 API 日本語リファレンス
ホームMedia.DeviceManager › IComponentAuthenticate

IComponentAuthenticate

COM
IIDa9889c00-6d2b-11d3-8496-00c04f79dbc0継承元IUnknown自前メソッド開始 vtbl3

メソッド 2

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

vtbl 3 HRESULT SACAuth(DWORD dwProtocolID, DWORD dwPass, BYTE* pbDataIn, DWORD dwDataInLen, BYTE** ppbDataOut, DWORD* pdwDataOutLen)
dwProtocolIDDWORDin使用する相互認証プロトコルの識別子を指定する。
dwPassDWORDin認証処理の段階(パス番号)を指定する。多段認証の進行を示す。
pbDataInBYTE*in認証チャレンジ等の入力データを格納したバッファ。
dwDataInLenDWORDin入力データの長さをバイト単位で指定する。
ppbDataOutBYTE**out認証応答データを受け取る出力バッファのポインタ。割り当て済み領域を返す。
pdwDataOutLenDWORD*out出力データの長さを受け取る出力。
vtbl 4 HRESULT SACGetProtocols(DWORD** ppdwProtocols, DWORD* pdwProtocolCount)
ppdwProtocolsDWORD**out対応する認証プロトコルID配列を受け取る出力。
pdwProtocolCountDWORD*outプロトコル配列の要素数を受け取る出力。

HSP用 COM定義

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

出力引数:
#define global IID_IComponentAuthenticate "{A9889C00-6D2B-11D3-8496-00C04F79DBC0}"
#usecom global IComponentAuthenticate IID_IComponentAuthenticate "{}"
#comfunc global IComponentAuthenticate_SACAuth          3 int,int,var,int,var,var
#comfunc global IComponentAuthenticate_SACGetProtocols  4 var,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。