Metode IAlternativeName::InitializeFromRawData (certenroll.h)

Artikel
02/23/2024

Metode InitializeFromRawData menginisialisasi objek dari GUID Algoritma Tanda Tangan Digital (DSA), nama direktori X.500, atau alamat Protokol Internet (IP) yang terkandung dalam array byte yang dikodekan Distinguished Encoding Rules (DER).

Sintaks

HRESULT InitializeFromRawData(
  [in] AlternativeNameType Type,
  [in] EncodingType        Encoding,
  [in] BSTR                strRawData
);

Parameter

[in] Type

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

Nilai	Makna
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.

[in] Encoding

Nilai enumerasi EncodingType yang mengidentifikasi jenis pengodean Unicode yang diterapkan ke parameter strRawData .

[in] strRawData

Variabel BSTR yang berisi data yang dikodekan DER.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan S_OK.

Jika fungsi gagal, fungsi mengembalikan nilai HRESULT yang menunjukkan kesalahan. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.

Menampilkan kode	Deskripsi
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	Objek sudah diinisialisasi.

Keterangan

Data mentah adalah array byte yang telah dikodekan dengan menggunakan Distinguished Encoding Rules (DER). Anda harus menentukan array byte sebagai string yang dikodekan Unicode.

Jika Anda menggunakan metode ini untuk menentukan GUID DSA (XCN_CERT_ALT_NAME_GUID), GUID dikaitkan dengan XCN_OID_NTDS_REPLICATION (1.3.6.1.4.1.311.25.1) pengidentifikasi objek (OID) dan dikodekan sebagai string oktet (array byte). Anda dapat mengambil OID dengan memanggil properti ObjectId . Anda dapat memanggil properti RawData untuk mengambil array byte yang dikodekan.

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_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 nama prinsipal pengguna (UPN).
XCN_CERT_ALT_NAME_OTHER_NAME	Nama terdiri dari OID dan array byte.

Anda dapat menggunakan metode InitializeFromOtherName untuk menentukan OID dan string nama yang sesuai, dan Anda dapat menggunakan metode InitializeFromString untuk menentukan alamat email, nama DNS, URL, OID terdaftar, atau nama prinsipal pengguna (UPN).

Persyaratan

Persyaratan	Nilai
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

Bagikan melalui