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

  • [アーティクル]

IX509NameValuePair インターフェイスは、汎用の名前と値のペアを表します。 証明書要求と登録プロセスによって作成される一般的な名前と値のペアがいくつかありますが、このオブジェクトを使用して任意の名前と値を指定できます。 IX509NameValuePairs コレクションは、IX509Enrollment オブジェクトと IX509CertificateRequestCmc オブジェクトから取得できます。 コレクションは関連していません。

name と value のペアと登録オブジェクト:
IX509Enrollment オブジェクトが証明機関 (CA) に証明書要求を送信する前に、名前と値のコレクションは、Name1:Value1\Name2:Value2\ という形式の連結属性文字列としてエンコードされます。 コレクションを取得するには、 NameValuePairs プロパティを 呼び出します。 IX509NameValuePairs オブジェクトを使用して、名前と値のペアをコレクションに追加できます。
name と value のペアと CMC 要求オブジェクト:
CMC 要求オブジェクト (IX509CertificateRequestCmc) には、TaggedAttribute、TaggedRequest、TaggedContentInfo ASN.1 構造体のシーケンスが含まれています。 詳細については、「CMC 属性」を参照してください。

TaggedAttribute 構造体には RegInfo 属性を含めることができます。 この属性は、名前と値のペア コレクションを含むバイト配列で構成されます。 バイト配列は、次の方法で作成されます。

  • 各名前と値の文字列は標準化されています。 たとえば、"%5C" エスケープは円記号 (\\) の代わりに使用されます。
  • 各名前と値のペアは、等号 (=) を使用して連結されます。
  • すべてのペアは、各ペアの間にアンパサンド (&) を使用して連結されます。
  • 結果は UTF-8 文字列としてエンコードされます。

次の例は、"RequesterName=Domain\TargetUser" の単一の名前と値のペアを含む RegInfo 属性を含む CMC 証明書の ASN.1 出力を示しています。


...
30 33              ; SEQUENCE (33 Bytes)
   02 01                            ; INTEGER (1 Bytes)
   |  02
   06 08                            ; OBJECT_ID (8 Bytes)
   |  2b 06 01 05 05 07 07 12
   |     ; 1.3.6.1.5.5.7.7.18 Reg Info
   31 24                ; SET (24 Bytes)
      04 22 ; OCTET_STRING (22 Bytes)
      52 65 71 75 65 73 74 65  72 4e 61 6d 65 3d 44 6f  ; RequesterName=Do
      6d 61 69 6e 25 35 43 54  61 72 67 65 74 55 73 65  ; main%5CTargetUse
      72 26                                             ; r& 
...

継承

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

メソッド

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

 
IX509NameValuePair::get_Name

名前と値のペアの名前部分を取得します。
IX509NameValuePair::get_Value

名前と値のペアの値部分を取得します。
IX509NameValuePair::Initialize

名前と関連付けられた値を含む文字列から オブジェクトを初期化します。

要件

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

こちらもご覧ください

CertEnroll インターフェイス

IDispatch

IX509NameValuePairs