Metode ICertEncodeAltName::SetNameEntry (certenc.h)

Artikel
02/23/2024

Metode SetNameEntry menetapkan nama pada indeks tertentu dari array nama alternatif.

Sebelum menggunakan metode ini, Anda harus memanggil ICertEncodeAltName::Reset sehingga objek mengetahui berapa banyak elemen dalam array.

Sintaks

HRESULT SetNameEntry(
  [in] LONG       NameIndex,
  [in] LONG       NameChoice,
  [in] const BSTR strName
);

Parameter

[in] NameIndex

Indeks berbasis nol yang menentukan indeks entri nama alternatif yang akan diatur.

Jika parameter NameChoice CERT_ALT_NAME_OTHER_NAME, ATAU (|) nilai indeks dengan EAN_NAMEOBJECTID (didefinisikan sebagai 0x80000000) untuk mengatur OID. Jika tidak, nilai biner diatur.

[in] NameChoice

Menentukan pilihan nama. Pilihan nama menunjukkan jenis nama alternatif sehingga dapat digunakan dengan benar. Ini harus menjadi salah satu nilai berikut.

Nilai	Makna
CERT_ALT_NAME_DIRECTORY_NAME	Nama tersebut adalah nama direktori.
CERT_ALT_NAME_DNS_NAME	Nama adalah string IA5 yang menentukan nama DNS (Sistem Nama Domain) dalam format host.entity.domain.
CERT_ALT_NAME_IP_ADDRESS	Nama adalah string oktet yang mewakili alamat Protokol Internet.
CERT_ALT_NAME_REGISTERED_ID	Nama adalah pengidentifikasi objek terdaftar (OID).
CERT_ALT_NAME_RFC822_NAME	Nama tersebut adalah alamat email.
CERT_ALT_NAME_URL	Nama adalah string IA5 yang berisi URL dalam format Service://HostName/Path.
CERT_ALT_NAME_OTHER_NAME	Nama terdiri dari pengidentifikasi objek (OID) dan BLOB biner.

[in] strName

Menentukan nama alternatif.

Mengembalikan nilai

VB

Jika metode berhasil, metode akan mengembalikan S_OK.

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tidak ada yang didukung
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	certenc.h (termasuk Certsrv.h)
Pustaka	Certidl.lib
DLL	Certenc.dll

Lihat juga

ICertEncodeAltName

Bagikan melalui