IX509ExtensionAlternativeNames 介面 (certenroll.h)

  • 發行項

IX509ExtensionAlternativeNames介面可讓您指定憑證主體的一或多個替代名稱表單。 憑證授權單位單位會將名稱系結至認證的公開金鑰，以處理延伸模組。 下列語法顯示延伸模組的 抽象語法標記法一 (ASN.1) 結構。 擴充值會使用可辨別編碼規則 (DER) 編碼，並包含在憑證要求中。


----------------------------------------------------------------------
-- AlternativeNames 
-- XCN_OID_SUBJECT_ALT_NAME2 (2.5.29.17)
----------------------------------------------------------------------

AltNames ::= SEQUENCE --#public-- OF GeneralName
GeneralNames ::= AltNames

GeneralName ::= CHOICE 
{
   otherName               [0] IMPLICIT OtherName,
   rfc822Name              [1] IMPLICIT IA5STRING,
   dNSName                 [2] IMPLICIT IA5STRING,
   x400Address             [3] IMPLICIT SeqOfAny,       -- Not supported
   directoryName           [4] EXPLICIT ANY,    
   ediPartyName            [5] IMPLICIT SeqOfAny,
   uniformResourceLocator  [6] IMPLICIT IA5STRING,
   iPAddress               [7] IMPLICIT OCTETSTRING,
   registeredID            [8] IMPLICIT EncodedObjectID -- Not supported
}

OtherName ::= SEQUENCE 
{
   type                    EncodedObjectID,
   value                   [0] EXPLICIT NOCOPYANY 
}

如果您使用 IAlternativeNames 集合來初始化此延伸模組，則支援下列名稱類型。

值 Description
XCN_CERT_ALT_NAME_OTHER_NAME 此名稱包含物件識別碼和包含名稱的位元組陣列。
XCN_CERT_ALT_NAME_RFC822_NAME 名稱是電子郵件地址。
XCN_CERT_ALT_NAME_DNS_NAME 此名稱為網域名稱系統名稱。
XCN_CERT_ALT_NAME_DIRECTORY_NAME 此名稱為 X.500 目錄名稱。
XCN_CERT_ALT_NAME_URL 此名稱為 URL。
XCN_CERT_ALT_NAME_IP_ADDRESS 此名稱是網際網路通訊協定 (IP) 位址。
XCN_CERT_ALT_NAME_REGISTERED_ID 此名稱是 OID) (已註冊 的物件識別碼 。
XCN_CERT_ALT_NAME_GUID 名稱為 GUID。 這是 otherName的形式。
XCN_CERT_ALT_NAME_USER_PRINCIPLE_NAME 此名稱是 UPN) (的使用者主體名稱 。 UPN 格式是以 RFC 822 為基礎。
 

若要將此擴充物件新增至 PKCS #10 要求或 CMC 要求，您必須先將它新增至 IX509Extensions 集合，並使用集合來初始化 IX509AttributeExtensions 物件。 如需詳細資訊，請參閱 PKCS #10 延伸模組 和 CMC 延伸模組 主題。

繼承

IX509ExtensionAlternativeNames介面繼承自IX509Extension。 IX509ExtensionAlternativeNames 也有下列類型的成員：

方法

IX509ExtensionAlternativeNames介面具有這些方法。

 
IX509ExtensionAlternativeNames：：get_AlternativeNames

擷取主體別名的集合。
IX509ExtensionAlternativeNames：：InitializeDecode

從包含擴充值的可辨別編碼規則 (DER) 編碼位元組陣列，初始化延伸模組。 (IX509ExtensionAlternativeNames.InitializeDecode)
IX509ExtensionAlternativeNames：：InitializeEncode

從 IAlternativeNames 集合初始化延伸模組。

規格需求

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

另請參閱

憑證註冊 API

擴充功能

IX509Extension