ホーム › Security.Cryptography.Certificates › ICertProperty
ICertProperty
COMIDispatch (デュアル)✅ IDispatch を実装(デュアルインターフェース)。HSP では
comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。メソッド 7
vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。
vtbl 7 HRESULT InitializeFromCertificate(VARIANT_BOOL MachineContext, EncodingType Encoding, LPWSTR strCertificate)
| MachineContext | VARIANT_BOOL | in | コンピューター コンテキストの証明書ストアを対象とするか否かを指定する。VARIANT_TRUE でコンピューター コンテキストを使用する。 |
| Encoding | EncodingType | in | strCertificate のエンコード形式を指定する EncodingType 値である。 |
| strCertificate | LPWSTR | in | プロパティの取得元となる証明書をエンコードした文字列である。 |
vtbl 8 HRESULT InitializeDecode(EncodingType Encoding, LPWSTR strEncodedData)
| Encoding | EncodingType | in | strEncodedData のエンコード形式を指定する EncodingType 値である。 |
| strEncodedData | LPWSTR | in | デコード対象となるエンコード済みの証明書プロパティ データを格納した文字列である。 |
vtbl 9 HRESULT get_PropertyId(CERTENROLL_PROPERTYID* pValue)
| pValue | CERTENROLL_PROPERTYID* | out | 証明書プロパティの識別子を示す CERTENROLL_PROPERTYID 値を受け取る出力先である。 |
vtbl 10 HRESULT put_PropertyId(CERTENROLL_PROPERTYID Value)
| Value | CERTENROLL_PROPERTYID | in | 設定する証明書プロパティの識別子を示す CERTENROLL_PROPERTYID 値である。 |
vtbl 11 HRESULT get_RawData(EncodingType Encoding, LPWSTR* pValue)
| Encoding | EncodingType | in | 出力する pValue の希望するエンコード形式を指定する EncodingType 値である。 |
| pValue | LPWSTR* | out | 証明書プロパティの生データ (RAW) を指定エンコード形式で受け取る出力先である。 |
vtbl 12 HRESULT RemoveFromCertificate(VARIANT_BOOL MachineContext, EncodingType Encoding, LPWSTR strCertificate)
| MachineContext | VARIANT_BOOL | in | コンピューター コンテキストの証明書を対象とするか否かを指定する。VARIANT_TRUE でコンピューター コンテキストを使用する。 |
| Encoding | EncodingType | in | strCertificate のエンコード形式を指定する EncodingType 値である。 |
| strCertificate | LPWSTR | in | プロパティを削除する対象の証明書をエンコードした文字列である。 |
vtbl 13 HRESULT SetValueOnCertificate(VARIANT_BOOL MachineContext, EncodingType Encoding, LPWSTR strCertificate)
| MachineContext | VARIANT_BOOL | in | コンピューター コンテキストの証明書を対象とするか否かを指定する。VARIANT_TRUE でコンピューター コンテキストを使用する。 |
| Encoding | EncodingType | in | strCertificate のエンコード形式を指定する EncodingType 値である。 |
| strCertificate | LPWSTR | in | プロパティ値を設定する対象の証明書をエンコードした文字列である。 |
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
出力引数:
#define global IID_ICertProperty "{728AB32E-217D-11DA-B2A4-000E7BBB2B09}" #usecom global ICertProperty IID_ICertProperty "{}" #comfunc global ICertProperty_InitializeFromCertificate 7 int,int,wstr #comfunc global ICertProperty_InitializeDecode 8 int,wstr #comfunc global ICertProperty_get_PropertyId 9 var #comfunc global ICertProperty_put_PropertyId 10 int #comfunc global ICertProperty_get_RawData 11 int,var #comfunc global ICertProperty_RemoveFromCertificate 12 int,int,wstr #comfunc global ICertProperty_SetValueOnCertificate 13 int,int,wstr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_ICertProperty "{728AB32E-217D-11DA-B2A4-000E7BBB2B09}" #usecom global ICertProperty IID_ICertProperty "{}" #comfunc global ICertProperty_InitializeFromCertificate 7 int,int,wstr #comfunc global ICertProperty_InitializeDecode 8 int,wstr #comfunc global ICertProperty_get_PropertyId 9 sptr #comfunc global ICertProperty_put_PropertyId 10 int #comfunc global ICertProperty_get_RawData 11 int,sptr #comfunc global ICertProperty_RemoveFromCertificate 12 int,int,wstr #comfunc global ICertProperty_SetValueOnCertificate 13 int,int,wstr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。