IX509ExtensionTemplateName インターフェイス (certenroll.h)

  • [アーティクル]

IX509ExtensionTemplateName インターフェイスは、テンプレート名拡張子の初期化または取得に使用できるメソッドとプロパティを定義します。 この拡張機能を 証明書要求 に配置して、証明書の発行または更新時に使用するテンプレートを 証明機関 に伝えることができます。 テンプレートは名前で識別されます。

メモCertificateTemplateName 拡張機能は、バージョン 1 のテンプレートを識別するために使用されます。 バージョン 2 テンプレートを識別するには、IX509ExtensionTemplate インターフェイスで定義されている CertificateTemplate 拡張機能を使用できます。

 

拡張子は名前と値のペアとしてエンコードされます。name は Unicode 文字列 "CertificateTemplate" と等しく、関連付けられている値はテンプレートの名前です。 次の構文は、"User" という名前のテンプレートの 抽象構文表記 1 (ASN.1) 出力の例を示しています。 拡張値は、Distinguished Encoding Rules (DER) を使用してエンコードされます。


30 42				; SEQUENCE (42 Bytes)
|  06 0a				; OBJECT_ID (a Bytes)
|  |  2b 06 01 04 01 82 37 0d  02 01
|  |     ; 1.3.6.1.4.1.311.13.2.1 Enrollment Name Value Pair
|  31 34				; SET (34 Bytes)
|     30 32			; SEQUENCE (32 Bytes)
|        1e 26			; UNICODE_STRING (26 Bytes)
|        |  00 43 00 65 00 72 00 74  00 69 00 66 00 69 00 63  ; .C.e.r.t.i.f.i.c
|        |  00 61 00 74 00 65 00 54  00 65 00 6d 00 70 00 6c  ; .a.t.e.T.e.m.p.l
|        |  00 61 00 74 00 65                                 ; .a.t.e
|        |     ; "CertificateTemplate"
|        1e 08			; UNICODE_STRING (8 Bytes)
|           00 55 00 73 00 65 00 72                           ; .U.s.e.r
|              ; "User"

この拡張オブジェクトを PKCS #10 要求または CMC 要求に追加するには、まずそれを IX509Extensions コレクションに追加し、コレクションを使用して IX509AttributeExtensions オブジェクトを初期化する必要があります。 詳細については、 PKCS #10 拡張機能 と CMC 拡張機能 に関するトピックを参照してください。

継承

IX509ExtensionTemplateName インターフェイスは IX509Extension から継承されます。 IX509ExtensionTemplateName には、次の種類のメンバーもあります。

メソッド

IX509ExtensionTemplateName インターフェイスには、これらのメソッドがあります。

 
IX509ExtensionTemplateName::get_TemplateName

テンプレートの名前を取得します。
IX509ExtensionTemplateName::InitializeDecode

拡張値を含むDistinguished Encoding Rules (DER) でエンコードされたバイト配列から拡張機能を初期化します。 (IX509ExtensionTemplateName.InitializeDecode)
IX509ExtensionTemplateName::InitializeEncode

テンプレート名を含む文字列から拡張機能を初期化します。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー certenroll.h

こちらもご覧ください

CertEnroll インターフェイス

IX509Extension