iAlternativeName 介面 (certenroll.h)
IAlternativeName 介面的集合是由 IX509ExtensionAlternativeNames 物件用來表示 AlternativeNames 延伸模組的實例。 集合是由 IAlternativeNames 介面表示。 下列語法顯示延伸模組的 抽象語法表示法一 (ASN.1) 結構。
----------------------------------------------------------------------
-- 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
}
您可以從 AlternativeNameType 列舉初始化 IAlternativeName 物件。 下列類型可供使用，但支援不同的初始化方法，如前所述。
| 值 | Description | 初始化方法 |
|---|---|---|
| XCN_CERT_ALT_NAME_OTHER_NAME | 此名稱是由 OID) 和位元組陣列 (物件識別碼 所組成。 | InitializeFromOtherName |
| XCN_CERT_ALT_NAME_RFC822_NAME | 名稱是電子郵件位址。 | InitializeFromString |
| XCN_CERT_ALT_NAME_DNS_NAME | 此名稱是功能變數名稱系統 (DNS) 名稱。 | InitializeFromString |
| XCN_CERT_ALT_NAME_DIRECTORY_NAME | 此名稱為 X.500 目錄名稱。 | InitializeFromRawData |
| XCN_CERT_ALT_NAME_URL | 此名稱為 URL。 | InitializeFromString |
| XCN_CERT_ALT_NAME_IP_ADDRESS | 此名稱是因特網通訊協定 (IP) 位址。 | InitializeFromRawData |
| XCN_CERT_ALT_NAME_REGISTERED_ID | 此名稱為已註冊的 OID。 | InitializeFromString |
| XCN_CERT_ALT_NAME_GUID | 名稱為 GUID。 | InitializeFromRawData |
| XCN_CERT_ALT_NAME_USER_PRINCIPLE_NAME | 此名稱是UPN) (的用戶主體名稱 。 | InitializeFromString |
繼承
IAlternativeName 介面繼承自 IDispatch 介面。 IAlternativeName 也有下列類型的成員：
方法
IAlternativeName 介面具有這些方法。
| IAlternativeName：：get_ObjectId 擷取與名稱相關聯的物件標識碼 (OID) 。 |
| IAlternativeName：：get_RawData 擷取包含名稱 可辨別編碼規則 (DER) 編碼位元組陣列。 |
| IAlternativeName：：get_StrValue 擷取包含電子郵件位址、功能變數名稱系統 (DNS) 名稱、URL、註冊物件識別碼 ( (OID) 的字串，或 UPN) 的用戶主體名稱。 |
| IAlternativeName：：get_Type 擷取替代名稱類型。 |
| IAlternativeName：：InitializeFromOtherName 從物件標識碼 (OID) 和相關聯的原始數據初始化物件， (位元組陣列) 。 |
| IAlternativeName：：InitializeFromRawData 從 DSA) GUID、X.500 目錄名稱或 (包含在 可辨別編碼規則 (DER) 編碼位元組陣組的因特網通訊協定) 位址，初始化 數位簽名演算法 (物件。 |
| IAlternativeName：：InitializeFromString 從包含電子郵件位址、功能變數名稱系統 (DNS) 名稱、URL、已註冊的物件標識碼 (OID) ，或 UPN) 的用戶主體 (名稱，初始化 物件。 |
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | certenroll.h |