Metode ICertEncodeAltName::GetNameChoice (certenc.h)

Metode GetNameChoice mengembalikan pilihan nama pada indeks tertentu dari array nama alternatif.

Sintaks

HRESULT GetNameChoice(
  [in]  LONG NameIndex,
  [out] LONG *pNameChoice
);

Parameter

[in] NameIndex

Menentukan indeks entri nama alternatif. Entri pertama berada pada nol indeks.

[out] pNameChoice

Penunjuk ke LONG yang menerima penentu pilihan nama.

Nilai kembali

C++

Jika metode berhasil, metode mengembalikan S_OK, dan parameter pNameChoice menunjuk ke nilai yang menunjukkan jenis nama alternatif. Ini adalah salah satu nilai berikut.

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

VB

Nilai yang dikembalikan adalah pilihan nama pada indeks yang ditentukan. Pilihan nama menunjukkan jenis nama alternatif sehingga dapat digunakan dengan benar. Ini harus menjadi salah satu nilai berikut.

Menampilkan kode	Deskripsi
CERT_ALT_NAME_DIRECTORY_NAME	Nama tersebut adalah nama direktori.
CERT_ALT_NAME_DNS_NAME	Nama adalah string IA5 yang berisi nama DNS (Sistem Nama Domain) dalam format Host.Entitas.Domain.
CERT_ALT_NAME_IP_ADDRESS	Nama adalah string oktet yang mewakili alamat protokol Internet.
CERT_ALT_NAME_REGISTERED_ID	Nama ini 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 ini terdiri dari OID dan BLOB biner.

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

ICertEncodeAltName::GetName

ICertEncodeAltName::SetNameEntry