Share via

Metode IX509AttributeClientId::InitializeEncode (certenroll.h)

  • Artikel

Metode InitializeEncode menginisialisasi atribut dari informasi tentang pengguna, komputer klien, dan aplikasi yang mengirimkan permintaan sertifikat.

Sintaks

HRESULT InitializeEncode(
  [in]           RequestClientInfoClientId ClientId,
  [in, optional] BSTR                      strMachineDnsName,
  [in, optional] BSTR                      strUserSamName,
  [in, optional] BSTR                      strProcessName
);

Parameter

[in] ClientId

Nilai enumerasi RequestClientInfoClientId yang mengidentifikasi jenis aplikasi yang membuat permintaan. Contohnya termasuk layanan pendaftaran otomatis, alat permintaan baris perintah, dan aplikasi permintaan kustom.

[in, optional] strMachineDnsName

Variabel BSTR yang berisi nama Sistem Nama Domain (DNS) komputer tempat permintaan dibuat, misalnya ComputerName.contoso.com. Jika Anda tidak memberikan nama, metode memanggil fungsi GetComputerNameEx . Jika nama tidak dapat ditemukan, metode gagal.

[in, optional] strUserSamName

Variabel BSTR yang berisi nama Manajer Akun Keamanan (SAM) untuk pengguna dalam formulir DomainName\UserName. Jika Anda tidak memberikan nama, metode memanggil fungsi GetUserNameEx . Jika nama tidak dapat ditemukan, metode gagal.

[in, optional] strProcessName

Variabel BSTR yang berisi nama aplikasi yang membuat permintaan sertifikat. Jika Anda tidak memberikan nama, metode memanggil fungsi GetCommandLine dan mengurai baris perintah. Jika nama tidak dapat ditemukan, metode gagal.

Menampilkan nilai

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

Pengidentifikasi objek (OID) untuk atribut ini XCN_OID_REQUEST_CLIENT_INFO (1.3.6.1.4.1.311.21.20). Untuk informasi selengkapnya, lihat CERTENROLL_OBJECTID. Atribut dibuat sebagai struktur Abstract Syntax Notation One (ASN.1) yang dikodekan dengan menggunakan Distinguished Encoding Rules (DER).

Anda harus memanggil InitializeEncode atau InitializeDecode sebelum Anda dapat menggunakan objek IX509AttributeClientId . Kedua metode saling melengkapi. Metode InitializeEncode memungkinkan Anda membuat struktur ASN.1 yang dikodekan dari data mentah, dan metode InitializeDecode memungkinkan Anda menginisialisasi data mentah dari struktur ASN.1 yang dikodekan. Anda dapat memanggil properti berikut untuk mengambil data mentah:

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

IX509AttributeClientId

InitializeDecode