ホーム › Security.Cryptography.Certificates › IX509CertificateRequestCmc2

IX509CertificateRequestCmc2

COMIDispatch (デュアル)

📘 Microsoft Learn (日本語) · English

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

IID728ab35d-217d-11da-b2a4-000e7bbb2b09継承元IX509CertificateRequestCmc呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl63

公式ドキュメント

IX509CertificateRequestCmc2 インターフェースは、CMC (Certificate Management Message over CMS) 証明書要求を表します。

メソッド 6

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

vtbl 63 HRESULT InitializeFromTemplate(X509CertificateEnrollmentContext context, IX509EnrollmentPolicyServer* pPolicyServer, IX509CertificateTemplate* pTemplate)

テンプレートを使用して証明書要求を初期化します。(IX509CertificateRequestCmc2.InitializeFromTemplate)

context

X509CertificateEnrollmentContext

要求される証明書がエンドユーザー、コンピューター、またはコンピューターに代わって動作する管理者のいずれを対象とするかを指定する X509CertificateEnrollmentContext 列挙型の値です。次のいずれかの値を指定できます。

値	意味
ContextUser	証明書はエンドユーザーのために要求されます。
ContextMachine	証明書はコンピューターのために要求されます。
ContextAdministratorForceMachine	証明書はコンピューターに代わって動作する管理者によって要求されます。

pPolicyServer

IX509EnrollmentPolicyServer*

inoptional

pTemplate パラメーターで指定されたテンプレートを含む証明書登録ポリシー (CEP) サーバーを表す IX509EnrollmentPolicyServer オブジェクトへのポインターです。

pTemplate

IX509CertificateTemplate*

inoptional

初期化中に使用するテンプレートを表す IX509CertificateTemplate オブジェクトへのポインターです。

戻り値

関数が成功した場合は S_OK を返します。

関数が失敗した場合は、エラーを示す HRESULT 値を返します。指定できる値には次の表に示すものが含まれますが、これらに限定されません。一般的なエラーコードの一覧については、Common HRESULT Values を参照してください。

リターンコード	説明
E_POINTER	pPolicyServer および pTemplate パラメーターを NULL にすることはできません。
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	証明書要求オブジェクトは既に初期化されています。

解説(Remarks)

InitializeFromTemplate メソッドは次のコレクションを作成します。

ICryptAttributes コレクション。
IX509Extensions コレクション。
既定の XCN_OID_KEY_USAGE および XCN_OID_BASIC_CONSTRAINTS2 オブジェクト識別子が設定された IObjectIds コレクション。
新しい要求から抑制される属性および拡張の OID 用の空の IObjectIds コレクション。

続いてメソッドはテンプレートを調べ、次の処理を実行します。

テンプレートで指定された拡張を IX509Extensions コレクションに追加します。
テンプレートがこれらをクリティカルでないと示している場合、既定のクリティカル拡張 (XCN_OID_KEY_USAGE および XCN_OID_BASIC_CONSTRAINTS2) をコレクションから削除します。テンプレートによってクリティカルとしてマークされた OID が追加されます。
テンプレートが対称アルゴリズムをサポートしている場合、SmimeCapabilities プロパティを設定します。
テンプレートが個別の署名アルゴリズム OID を必要とする場合、AlternateSignatureAlgorithm プロパティを設定します。
IX509SignatureInformation オブジェクトを作成します。
アルゴリズムがテンプレートで指定されている場合、ハッシュアルゴリズム OID を作成し、IX509SignatureInformation オブジェクトに設定します。
アルゴリズムがテンプレートで指定されている場合、非対称暗号化アルゴリズム OID を作成し、IX509SignatureInformation オブジェクトに設定します。
テンプレートの設定から IX509PrivateKey プロパティの多くを設定します。

CSPInformations プロパティが NULL の場合、メソッドはコンピューターにインストールされているプロバイダーから ICspInformations コレクションを作成します。

vtbl 64 HRESULT InitializeFromInnerRequestTemplate(IX509CertificateRequest* pInnerRequest, IX509EnrollmentPolicyServer* pPolicyServer, IX509CertificateTemplate* pTemplate)

内部要求オブジェクトとテンプレートから証明書要求を初期化します。

pInnerRequest	IX509CertificateRequest*	inoptional	内部要求オブジェクトを表す IX509CertificateRequest インターフェースへのポインターです。これは PKCS #10 要求または CMC 要求のいずれかです。
pPolicyServer	IX509EnrollmentPolicyServer*	inoptional	pTemplate パラメーターで指定されたテンプレートを含む証明書登録ポリシー (CEP) サーバーを表す IX509EnrollmentPolicyServer オブジェクトへのポインターです。
pTemplate	IX509CertificateTemplate*	inoptional	初期化中に使用するテンプレートを表す IX509CertificateTemplate オブジェクトへのポインターです。

戻り値

関数が成功した場合は S_OK を返します。

リターンコード/値	説明
CRYPT_E_INVALID_MSG_TYPE	pInnerRequest パラメーターに渡す要求オブジェクトは、PKCS #10 要求または CMC 要求である必要があります。
E_POINTER	pInnerRequest、pPolicyServer、および pTemplate パラメーターを NULL にすることはできません。
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	要求オブジェクトは既に初期化されています。

解説(Remarks)

テンプレートを指定することで、内部要求に含まれていない可能性がある情報を外部要求オブジェクトに追加できます。たとえば、内部要求に必要な拡張が含まれていない場合、それらを含むテンプレートを提供できます。

InitializeFromInnerRequestTemplate メソッドは次を行います。

空の ICryptAttributes コレクションを作成します。
空の IX509NameValuePairs コレクションを作成します。
空の IX509Extensions コレクションを作成します。
クリティカル拡張用の IObjectIds コレクションを作成し、XCN_OID_KEY_USAGE および XCN_OID_BASIC_CONSTRAINTS2 オブジェクト識別子 (OID) を追加します。
要求オブジェクトから抑制される OID の空の IObjectIds コレクションを作成します。
空の ISignerCertificates コレクションを作成します。
テンプレートからプライベートキーのフラグを取得します。
テンプレートのフラグまたは設定で必要とされる場合、ArchivePrivateKey プロパティを設定します。
暗号化アルゴリズムが指定されている場合、テンプレートからそれを取得し、EncryptionAlgorithm プロパティを設定します。
可能な場合、EncryptionStrength プロパティを設定します。

vtbl 65 HRESULT get_PolicyServer(IX509EnrollmentPolicyServer** ppPolicyServer)

初期化中に使用されたテンプレートを含む証明書登録ポリシー (CEP) サーバーを取得します。(IX509CertificateRequestCmc2.get_PolicyServer)

ppPolicyServer

IX509EnrollmentPolicyServer**

out

要求に関連付けられた IX509EnrollmentPolicyServer オブジェクトを受け取るポインタである。

vtbl 66 HRESULT get_Template(IX509CertificateTemplate** ppTemplate)

初期化中に使用された証明書要求テンプレートを取得します。(IX509CertificateRequestCmc2.get_Template)

ppTemplate

IX509CertificateTemplate**

out

要求に関連付けられた IX509CertificateTemplate オブジェクトを受け取るポインタである。

vtbl 67 HRESULT CheckSignature(Pkcs10AllowedSignatureTypes AllowedSignatureTypes)

証明書要求が署名されており、署名が有効であることを検証します。(IX509CertificateRequestCmc2.CheckSignature)

AllowedSignatureTypes

Pkcs10AllowedSignatureTypes

Pkcs10AllowedSignatureTypes 列挙型の値です。次の値のビットごとの組み合わせを指定できます。

値	意味
AllowedKeySignature	非対称キーを使用して生成された署名が許可されます。このフラグが設定されている場合、署名は内部 PKCS #10 要求内の公開キーに対して検証されます。これが既定のフラグです。
AllowedNullSignature	Null 署名の署名が許可されます。

戻り値

関数が成功した場合は S_OK を返します。

リターンコード	説明
CRYPT_E_NO_SIGNER	証明書要求は署名されていません。
ERROR_INVALID_STATE	署名の種類が AllowedSignatureTypes パラメーターで指定されていません。
NTE_BAD_SIGNATURE	AllowedSignatureTypes パラメーターで指定された値は、Pkcs10AllowedSignatureTypes 列挙型のメンバーではありません。

解説(Remarks)

このメソッドは公開キーを使用して署名を復号し、署名を証明書要求のハッシュと比較します。

vtbl 68 HRESULT CheckCertificateSignature(ISignerCertificate* pSignerCertificate, VARIANT_BOOL ValidateCertificateChain)

指定された署名者の署名を検証します。

pSignerCertificate	ISignerCertificate*	inoptional	署名証明書を表す ISignerCertificate インターフェースへのポインターです。
ValidateCertificateChain	VARIANT_BOOL	in	証明書チェーンも検証するかどうかを指定するブール値です。このパラメーターは NULL にできます。

戻り値

関数が成功した場合は S_OK を返します。

リターンコード/値	説明
E_POINTER	pSignerCertificate パラメーターを NULL にすることはできません。
CERTSRV_E_PROPERTY_EMPTY	署名者証明書が見つかりません。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

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

#define global IID_IX509CertificateRequestCmc2 "{728AB35D-217D-11DA-B2A4-000E7BBB2B09}"
#usecom global IX509CertificateRequestCmc2 IID_IX509CertificateRequestCmc2 "{}"
#comfunc global IX509CertificateRequestCmc2_InitializeFromTemplate              63 int,sptr,sptr
#comfunc global IX509CertificateRequestCmc2_InitializeFromInnerRequestTemplate  64 sptr,sptr,sptr
#comfunc global IX509CertificateRequestCmc2_get_PolicyServer                    65 sptr
#comfunc global IX509CertificateRequestCmc2_get_Template                        66 sptr
#comfunc global IX509CertificateRequestCmc2_CheckSignature                      67 int
#comfunc global IX509CertificateRequestCmc2_CheckCertificateSignature           68 sptr,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。