ホーム › Security.Cryptography.Certificates › ICertRequest3

ICertRequest3

COMIDispatch (デュアル)

✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。

IIDafc8f92b-33a2-4861-bf36-2933b7cd67b3継承元ICertRequest2呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl20

メソッド 4

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 20 HRESULT SetCredential(INT hWnd, X509EnrollmentAuthFlags AuthType, LPWSTR strCredential, LPWSTR strPassword)

hWnd	INT	in	認証 UI を表示する際の親ウィンドウハンドル (値) を指定する。
AuthType	X509EnrollmentAuthFlags	in	使用する認証方式を指定する X509EnrollmentAuthFlags である。
strCredential	LPWSTR	in	認証に使用するユーザー名または資格情報を指定する。
strPassword	LPWSTR	in	認証に使用するパスワードを指定する。

vtbl 21 HRESULT GetRequestIdString(LPWSTR* pstrRequestId)

pstrRequestId

LPWSTR*

out

直前に送信した要求の要求 ID を文字列として受け取るポインタである。

vtbl 22 HRESULT GetIssuedCertificate2(LPWSTR strConfig, LPWSTR strRequestId, LPWSTR strSerialNumber, CR_DISP* pDisposition)

strConfig	LPWSTR	in	対象 CA の構成文字列を指定する。
strRequestId	LPWSTR	in	発行済み証明書を識別する要求 ID を文字列で指定する。
strSerialNumber	LPWSTR	in	発行済み証明書を識別するシリアル番号を指定する。要求 ID で検索する場合は NULL を指定する。
pDisposition	CR_DISP*	out	取得結果の処理状態を受け取る CR_DISP へのポインタである。

vtbl 23 HRESULT GetRefreshPolicy(VARIANT_BOOL* pValue)

pValue

VARIANT_BOOL*

out

ポリシーを更新するかどうかの設定を受け取る VARIANT_BOOL へのポインタである。

HSP用 COM定義

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

出力引数:

#define global IID_ICertRequest3 "{AFC8F92B-33A2-4861-BF36-2933B7CD67B3}"
#usecom global ICertRequest3 IID_ICertRequest3 "{}"
#comfunc global ICertRequest3_SetCredential          20 int,int,wstr,wstr
#comfunc global ICertRequest3_GetRequestIdString     21 var
#comfunc global ICertRequest3_GetIssuedCertificate2  22 wstr,wstr,wstr,var
#comfunc global ICertRequest3_GetRefreshPolicy       23 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_ICertRequest3 "{AFC8F92B-33A2-4861-BF36-2933B7CD67B3}"
#usecom global ICertRequest3 IID_ICertRequest3 "{}"
#comfunc global ICertRequest3_SetCredential          20 int,int,wstr,wstr
#comfunc global ICertRequest3_GetRequestIdString     21 sptr
#comfunc global ICertRequest3_GetIssuedCertificate2  22 wstr,wstr,wstr,sptr
#comfunc global ICertRequest3_GetRefreshPolicy       23 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。