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

ICspInformations

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

メソッド 12

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

vtbl 7 HRESULT get_ItemByIndex(INT Index, ICspInformation** pVal)
IndexINTin取得する項目の 0 起点のインデックスを指定する。
pValICspInformation**out指定したインデックスの ICspInformation オブジェクトを受け取るインターフェイスポインタへのポインタである。
vtbl 8 HRESULT get_Count(INT* pVal)
pValINT*outコレクション内の CSP 情報数を受け取る INT へのポインタである。
vtbl 9 HRESULT get__NewEnum(IUnknown** pVal)
pValIUnknown**outコレクションを反復処理するための列挙子を受け取る IUnknown インターフェイスポインタへのポインタである。
vtbl 10 HRESULT Add(ICspInformation* pVal)
pValICspInformation*inoptionalコレクションに追加する ICspInformation オブジェクトへのポインタである。
vtbl 11 HRESULT Remove(INT Index)
IndexINTinコレクションから削除する項目の 0 起点のインデックスを指定する。
vtbl 12 HRESULT Clear()
vtbl 13 HRESULT AddAvailableCsps()
vtbl 14 HRESULT get_ItemByName(LPWSTR strName, ICspInformation** ppCspInformation)
strNameLPWSTRin取得する CSP の名前を指定する。
ppCspInformationICspInformation**out指定した名前の ICspInformation オブジェクトを受け取るインターフェイスポインタへのポインタである。
vtbl 15 HRESULT GetCspStatusFromProviderName(LPWSTR strProviderName, X509KeySpec LegacyKeySpec, ICspStatus** ppValue)
strProviderNameLPWSTRin対象とするプロバイダー名を指定する。
LegacyKeySpecX509KeySpecinレガシー CSP の場合に使用する鍵指定を表す X509KeySpec である。
ppValueICspStatus**outプロバイダーの状態を表す ICspStatus オブジェクトを受け取るインターフェイスポインタへのポインタである。
vtbl 16 HRESULT GetCspStatusesFromOperations(AlgorithmOperationFlags Operations, ICspInformation* pCspInformation, ICspStatuses** ppValue)
OperationsAlgorithmOperationFlagsin対象とする操作を指定する AlgorithmOperationFlags である。
pCspInformationICspInformation*inoptional対象を限定する ICspInformation へのポインタである。すべてを対象とする場合は NULL を指定する。
ppValueICspStatuses**out条件に一致する CSP 状態のコレクションを受け取るインターフェイスポインタへのポインタである。
vtbl 17 HRESULT GetEncryptionCspAlgorithms(ICspInformation* pCspInformation, ICspAlgorithms** ppValue)
pCspInformationICspInformation*inoptional対象とする ICspInformation へのポインタである。
ppValueICspAlgorithms**out暗号化に利用可能なアルゴリズムのコレクションを受け取るインターフェイスポインタへのポインタである。
vtbl 18 HRESULT GetHashAlgorithms(ICspInformation* pCspInformation, IObjectIds** ppValue)
pCspInformationICspInformation*inoptional対象とする ICspInformation へのポインタである。
ppValueIObjectIds**out利用可能なハッシュアルゴリズムの OID コレクションを受け取るインターフェイスポインタへのポインタである。

HSP用 COM定義

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

出力引数: 
#define global IID_ICspInformations "{728AB308-217D-11DA-B2A4-000E7BBB2B09}"
#usecom global ICspInformations IID_ICspInformations "{}"
#comfunc global ICspInformations_get_ItemByIndex               7 int,sptr
#comfunc global ICspInformations_get_Count                     8 var
#comfunc global ICspInformations_get__NewEnum                  9 sptr
#comfunc global ICspInformations_Add                           10 sptr
#comfunc global ICspInformations_Remove                        11 int
#comfunc global ICspInformations_Clear                         12
#comfunc global ICspInformations_AddAvailableCsps              13
#comfunc global ICspInformations_get_ItemByName                14 wstr,sptr
#comfunc global ICspInformations_GetCspStatusFromProviderName  15 wstr,int,sptr
#comfunc global ICspInformations_GetCspStatusesFromOperations  16 int,sptr,sptr
#comfunc global ICspInformations_GetEncryptionCspAlgorithms    17 sptr,sptr
#comfunc global ICspInformations_GetHashAlgorithms             18 sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。