Metode IAlternativeName::InitializeFromString (certenroll.h)

Artikel
08/22/2023

Metode InitializeFromString menginisialisasi objek dari string yang berisi alamat email, nama Sistem Nama Domain (DNS), URL, pengidentifikasi objek terdaftar (OID), atau nama prinsipal pengguna (UPN).

Sintaks

HRESULT InitializeFromString(
  [in] AlternativeNameType Type,
  [in] BSTR                strValue
);

Parameter

[in] Type

Nilai enumerasi AlternativeNameType yang mengidentifikasi jenis nama yang diwakili oleh string input yang terkandung dalam parameter strValue . Ini harus menjadi salah satu nilai berikut.

Nilai	Makna
XCN_CERT_ALT_NAME_RFC822_NAME	Nama tersebut adalah alamat email.
XCN_CERT_ALT_NAME_DNS_NAME	Nama tersebut adalah nama DNS.
XCN_CERT_ALT_NAME_URL	Namanya adalah URL.
XCN_CERT_ALT_NAME_REGISTERED_ID	Namanya adalah OID terdaftar.
XCN_CERT_ALT_NAME_USER_PRINCIPLE_NAME	Namanya adalah UPN.

[in] strValue

Variabel BSTR yang berisi nama.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan S_OK.

Jika fungsi gagal, fungsi mengembalikan nilai HRESULT yang menunjukkan kesalahan. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.

Keterangan

Jika Anda menggunakan metode ini untuk menentukan UPN, UPN dikaitkan dengan OID XCN_OID_NT_PRINCIPAL_NAME (1.3.6.1.4.1.311.20.2.3) dan Distinguished Encoding Rules (DER) dikodekan. Anda dapat memanggil properti RawData untuk mengambil array byte yang dikodekan. Anda dapat mengambil OID dengan memanggil properti ObjectId .

Jika Anda menggunakan metode ini untuk menentukan salah satu jenis nama berikut, metode akan mengembalikan E_INVALIDARG.

Nilai	Deskripsi
XCN_CERT_ALT_NAME_UNKNOWN	Jenis nama tidak diidentifikasi.
XCN_CERT_ALT_NAME_OTHER_NAME	Nama terdiri dari OID dan array byte.
XCN_CERT_ALT_NAME_DIRECTORY_NAME	Nama tersebut adalah nama direktori X.500 .
XCN_CERT_ALT_NAME_IP_ADDRESS	Namanya adalah alamat IP.
XCN_CERT_ALT_NAME_GUID	Nama tersebut adalah GUID.

Anda dapat menggunakan metode InitializeFromOtherName untuk menentukan OID dan string nama yang sesuai, dan Anda dapat menggunakan metode InitializeFromRawData untuk menentukan NAMA direktori GUID, alamat IP, atau X.500.

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
DLL	CertEnroll.dll

Lihat juga

IAlternativeName

IAlternativeNames

IX509ExtensionAlternativeNames

Bagikan melalui