Antarmuka IX509ExtensionAlternativeNames (certenroll.h)
Antarmuka IX509ExtensionAlternativeNames memungkinkan Anda menentukan satu atau beberapa formulir nama alternatif untuk subjek sertifikat. Otoritas sertifikasi memproses ekstensi dengan mengikat nama ke kunci publik bersertifikat. Sintaks berikut menunjukkan struktur Abstract Syntax Notation One (ASN.1) ekstensi. Nilai ekstensi dikodekan dengan menggunakan Distinguished Encoding Rules (DER) dan disertakan dalam permintaan sertifikat.
----------------------------------------------------------------------
-- 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
}
Jika Anda menginisialisasi ekstensi ini dengan menggunakan koleksi IAlternativeNames , jenis nama berikut didukung.
Nilai | Deskripsi |
---|---|
XCN_CERT_ALT_NAME_OTHER_NAME | Nama terdiri dari pengidentifikasi objek dan array byte yang berisi nama. |
XCN_CERT_ALT_NAME_RFC822_NAME | Nama tersebut adalah alamat email. |
XCN_CERT_ALT_NAME_DNS_NAME | Nama tersebut adalah nama Sistem Nama Domain. |
XCN_CERT_ALT_NAME_DIRECTORY_NAME | Nama tersebut adalah nama direktori X.500 . |
XCN_CERT_ALT_NAME_URL | Namanya adalah URL. |
XCN_CERT_ALT_NAME_IP_ADDRESS | Nama tersebut adalah alamat Protokol Internet (IP). |
XCN_CERT_ALT_NAME_REGISTERED_ID | Nama ini adalah pengidentifikasi objek terdaftar (OID). |
XCN_CERT_ALT_NAME_GUID | Nama tersebut adalah GUID. Ini adalah bentuk otherName. |
XCN_CERT_ALT_NAME_USER_PRINCIPLE_NAME | Nama tersebut adalah nama prinsipal pengguna (UPN). Format UPN didasarkan pada RFC 822. |
Untuk menambahkan objek ekstensi ini ke permintaan PKCS #10 atau permintaan CMC, Anda harus terlebih dahulu menambahkannya ke koleksi IX509Extensions dan menggunakan koleksi untuk menginisialisasi objek IX509AttributeExtensions . Untuk informasi selengkapnya, lihat topik Ekstensi #10 PKCS dan Ekstensi CMC .
Warisan
Antarmuka IX509ExtensionAlternativeNames mewarisi dari IX509Extension. IX509ExtensionAlternativeNames juga memiliki jenis anggota ini:
Metode
Antarmuka IX509ExtensionAlternativeNames memiliki metode ini.
IX509ExtensionAlternativeNames::get_AlternativeNames Mengambil kumpulan nama alternatif subjek. |
IX509ExtensionAlternativeNames::InitializeDecode Menginisialisasi ekstensi dari array byte yang dikodekan Distinguished Encoding Rules (DER) yang berisi nilai ekstensi. (IX509ExtensionAlternativeNames.InitializeDecode) |
IX509ExtensionAlternativeNames::InitializeEncode Menginisialisasi ekstensi dari koleksi IAlternativeNames. |
Persyaratan
Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | certenroll.h |