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 |