IX509NameValuePair 介面 (certenroll.h)

  • 發行項

IX509NameValuePair 介面代表泛型名稱/值組。 雖然憑證要求和註冊程式建立了一些常見的名稱/值組，但您可以使用這個物件來指定任何名稱和值。 您可以從 IX509Enrollment 物件和 IX509CertificateRequestCmc 物件擷取 IX509NameValuePairs 集合。 集合不相關。

name-value 配對和註冊物件：
在IX509Enrollment物件將憑證要求提交至證書頒發機構單位 (CA) 之前，name-value 集合會編碼為格式為 Name1：Value1\Name2：Value2\ 的串連屬性字符串。 您可以呼叫 NameValuePairs 屬性來擷取集合。 您可以使用 IX509NameValuePairs 物件，將名稱/值組新增至集合。
name-value 配對和 CMC 要求物件：
CMC 要求物件 (IX509CertificateRequestCmc) 包含 TagedAttribute、 TaggedRequest 和 TaggedContentInfo ASN.1 結構的序列。 如需詳細資訊，請參閱 CMC 屬性

TaggedAttribute 結構可以包含 RegInfo 屬性。 這個屬性是由包含名稱/值組集合的位元組陣組所組成。 位元組陣陣會以下列方式建立：

  • 每個名稱/值字串都會標準化。 例如，“%5C” 逸出會取代反斜杠 (\\) 字元。
  • 每個名稱/值組都會使用等號 (=) 串連。
  • 所有配對都會使用每個配對之間的連 (&) 串連。
  • 結果會編碼為UTF-8字串。

下列範例顯示 CMC 憑證的 ASN.1 輸出，其中包含包含 “RequesterName=Domain\TargetUser” 單一名稱/值組的 RegInfo 屬性。


...
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

擷取 name-value 配對的名稱部分。
IX509NameValuePair：：get_Value

擷取名稱/值組的值部分。
IX509NameValuePair：：Initialize

從包含名稱和相關聯值的字串初始化物件。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 certenroll.h

另請參閱

CertEnroll 介面

IDispatch

IX509NameValuePairs