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

IMSCEPSetup

COMIDispatch (デュアル)
📘 Microsoft Learn (日本語) · English
✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IID4f7761bb-9f3b-4592-9ee0-9a73259c313e継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

メソッド 12

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

vtbl 7 HRESULT get_MSCEPErrorId(INT* pVal)
pValINT*out直近の操作で発生したエラーの ID を受け取る INT へのポインタである。
vtbl 8 HRESULT get_MSCEPErrorString(LPWSTR* pVal)
pValLPWSTR*out直近の操作で発生したエラーの説明文字列を受け取る LPWSTR へのポインタである。
vtbl 9 HRESULT InitializeDefaults()
vtbl 10 HRESULT GetMSCEPSetupProperty(MSCEPSetupProperty propertyId, VARIANT* pVal)
propertyIdMSCEPSetupPropertyin取得する MSCEP セットアッププロパティの種類を指定する MSCEPSetupProperty 値である。
pValVARIANT*out取得したプロパティの値を受け取る VARIANT へのポインタである。
vtbl 11 HRESULT SetMSCEPSetupProperty(MSCEPSetupProperty propertyId, VARIANT* pPropertyValue)
propertyIdMSCEPSetupPropertyin設定する MSCEP セットアッププロパティの種類を指定する MSCEPSetupProperty 値である。
pPropertyValueVARIANT*in設定するプロパティの値を保持する VARIANT へのポインタである。
vtbl 12 HRESULT SetAccountInformation(LPWSTR bstrUserName, LPWSTR bstrPassword)
bstrUserNameLPWSTRinMSCEP サービスが使用するアカウントのユーザー名を渡す。
bstrPasswordLPWSTRinMSCEP サービスが使用するアカウントのパスワードを渡す。
vtbl 13 HRESULT IsMSCEPStoreEmpty(VARIANT_BOOL* pbEmpty)
pbEmptyVARIANT_BOOL*outMSCEP の証明書ストアが空かどうかを受け取る VARIANT_BOOL へのポインタである。
vtbl 14 HRESULT GetProviderNameList(VARIANT_BOOL bExchange, VARIANT* pVal)
bExchangeVARIANT_BOOLin鍵交換キー用のプロバイダーを対象とするかどうかを指定する VARIANT_BOOL 値を渡す。
pValVARIANT*out利用可能な暗号化サービスプロバイダー名の一覧を受け取る VARIANT へのポインタである。
vtbl 15 HRESULT GetKeyLengthList(VARIANT_BOOL bExchange, LPWSTR bstrProviderName, VARIANT* pVal)
bExchangeVARIANT_BOOLin鍵交換キー用のキー長を対象とするかどうかを指定する VARIANT_BOOL 値を渡す。
bstrProviderNameLPWSTRinキー長一覧を問い合わせる対象のプロバイダー名を渡す。
pValVARIANT*out指定プロバイダーがサポートするキー長の一覧を受け取る VARIANT へのポインタである。
vtbl 16 HRESULT Install()
vtbl 17 HRESULT PreUnInstall()
vtbl 18 HRESULT PostUnInstall()

HSP用 COM定義

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

出力引数: 
#define global IID_IMSCEPSetup "{4F7761BB-9F3B-4592-9EE0-9A73259C313E}"
#usecom global IMSCEPSetup IID_IMSCEPSetup "{}"
#comfunc global IMSCEPSetup_get_MSCEPErrorId       7 var
#comfunc global IMSCEPSetup_get_MSCEPErrorString   8 var
#comfunc global IMSCEPSetup_InitializeDefaults     9
#comfunc global IMSCEPSetup_GetMSCEPSetupProperty  10 int,var
#comfunc global IMSCEPSetup_SetMSCEPSetupProperty  11 int,var
#comfunc global IMSCEPSetup_SetAccountInformation  12 wstr,wstr
#comfunc global IMSCEPSetup_IsMSCEPStoreEmpty      13 var
#comfunc global IMSCEPSetup_GetProviderNameList    14 int,var
#comfunc global IMSCEPSetup_GetKeyLengthList       15 int,wstr,var
#comfunc global IMSCEPSetup_Install                16
#comfunc global IMSCEPSetup_PreUnInstall           17
#comfunc global IMSCEPSetup_PostUnInstall          18
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。