IX509ExtensionAlternativeNames 接口 (certenroll.h)
使用 IX509ExtensionAlternativeNames 接口可以为证书使用者指定一个或多个可选名称表单。 证书颁发机构通过将名称绑定到已认证的公钥来处理扩展。 以下语法演示扩展的 抽象语法表示法 One (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 集合初始化此扩展，则支持以下名称类型。
| 值 | 说明 |
|---|---|
| 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 | 该名称是 Internet 协议 (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 |