IX509AttributeRenewalCertificate
COMIDispatch (デュアル)comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。公式ドキュメント
更新される証明書を格納する属性を表します。この属性は PKCS に自動的に配置されます
メソッド 3
vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。
更新対象の証明書を使用して属性を初期化します。
| Encoding | EncodingType | in | strCert パラメーターに格納される証明書に適用される Unicode エンコードの種類を指定する EncodingType 列挙値です。 |
| strCert | LPWSTR | in | DER エンコードされた証明書を格納する BSTR 変数です。 Windows 7 および Windows Server 2008 R2 以降では、エンコードされた証明書の代わりに、証明書のサムプリントまたはシリアル番号を指定できます。その場合、関数は一致する証明書を探して適切なローカルストアを検索します。次の点に注意してください。
|
戻り値
関数が成功した場合、S_OK を返します。
関数が失敗した場合は、エラーを示す HRESULT 値を返します。一般的なエラーコードの一覧については、Common HRESULT Values を参照してください。
解説(Remarks)
この属性の オブジェクト識別子 (OID) は XCN_OID_RENEWAL_CERTIFICATE (1.3.6.1.4.1.311.13.1) です。詳細については、CERTENROLL_OBJECTID を参照してください。
IX509AttributeRenewalCertificate オブジェクトを使用する前に、InitializeEncode または InitializeDecode のいずれかを呼び出す必要があります。この 2 つのメソッドは互いに補完し合います。InitializeEncode メソッドは生データからエンコードされた Abstract Syntax Notation One (ASN.1) 構造を構築でき、InitializeDecode メソッドはエンコードされた ASN.1 構造から生データを初期化できます。RenewalCertificate プロパティを呼び出して生データを取得できます。
更新対象の証明書を格納した Distinguished Encoding Rules (DER) エンコードのバイト配列からオブジェクトを初期化します。
| Encoding | EncodingType | in | 入力文字列に適用される Unicode エンコードの種類を指定する EncodingType 列挙値です。 |
| strEncodedData | LPWSTR | in | DER エンコードされた証明書を格納する BSTR 変数です。 Windows 7 および Windows Server 2008 R2 以降では、エンコードされた証明書の代わりに、証明書のサムプリントまたはシリアル番号を指定できます。その場合、関数は一致する証明書を探して適切なローカルストアを検索します。次の点に注意してください。
|
戻り値
関数が成功した場合、S_OK を返します。
関数が失敗した場合は、エラーを示す HRESULT 値を返します。一般的なエラーコードの一覧については、Common HRESULT Values を参照してください。
解説(Remarks)
この属性の オブジェクト識別子 (OID) は XCN_OID_RENEWAL_CERTIFICATE (1.3.6.1.4.1.311.13.1) です。詳細については、CERTENROLL_OBJECTID を参照してください。
属性値を格納する DER エンコードされた Abstract Syntax Notation One (ASN.1) オブジェクトがある場合は、このメソッドを使用できます。DER エンコードされたオブジェクトは Unicode エンコードの文字列で指定する必要があります。詳細については、IBinaryConverter インターフェースを参照してください。
IX509AttributeRenewalCertificate オブジェクトを使用する前に、InitializeEncode または InitializeDecode のいずれかを呼び出す必要があります。この 2 つのメソッドは互いに補完し合います。InitializeEncode メソッドは生データからエンコードされた ASN.1 構造を構築でき、InitializeDecode メソッドはエンコードされた ASN.1 構造から生データを初期化できます。RenewalCertificate プロパティを呼び出して生データを取得できます。
更新対象の証明書を取得します。
| Encoding | EncodingType | in | 出力する pValue の希望するエンコード形式を指定する EncodingType 値である。 |
| pValue | LPWSTR* | out | 指定エンコード形式による更新対象証明書の文字列を受け取る出力先である。 |
解説(Remarks)
RenewalCertificate プロパティを初期化するには、InitializeEncode メソッドまたは InitializeDecode メソッドを呼び出します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IX509AttributeRenewalCertificate "{728AB326-217D-11DA-B2A4-000E7BBB2B09}" #usecom global IX509AttributeRenewalCertificate IID_IX509AttributeRenewalCertificate "{}" #comfunc global IX509AttributeRenewalCertificate_InitializeEncode 10 int,wstr #comfunc global IX509AttributeRenewalCertificate_InitializeDecode 11 int,wstr #comfunc global IX509AttributeRenewalCertificate_get_RenewalCertificate 12 int,var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_IX509AttributeRenewalCertificate "{728AB326-217D-11DA-B2A4-000E7BBB2B09}" #usecom global IX509AttributeRenewalCertificate IID_IX509AttributeRenewalCertificate "{}" #comfunc global IX509AttributeRenewalCertificate_InitializeEncode 10 int,wstr #comfunc global IX509AttributeRenewalCertificate_InitializeDecode 11 int,wstr #comfunc global IX509AttributeRenewalCertificate_get_RenewalCertificate 12 int,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。