Metode ICertRequest2::GetCAPropertyDisplayName (certcli.h)

Artikel
02/26/2024

Metode GetCAPropertyDisplayName mengambil nama tampilan properti untuk properti otoritas sertifikasi (CA).

Sintaks

HRESULT GetCAPropertyDisplayName(
  [in]          const BSTR strConfig,
  [in]          LONG       PropId,
  [out, retval] BSTR       *pstrDisplayName
);

Parameter

[in] strConfig

Mewakili string konfigurasi yang valid untuk CA dalam bentuk ComputerName\CAName, di mana ComputerName adalah nama jaringan server Certificate Services, dan CAName adalah nama umum CA, seperti yang dimasukkan selama penyiapan Layanan Sertifikat. Untuk informasi tentang nama string konfigurasi, lihat ICertConfig.

[in] PropId

Menentukan pengidentifikasi properti. Untuk informasi tentang parameter ini, lihat tabel di ICertAdmin2::GetCAProperty.

[out, retval] pstrDisplayName

Penunjuk ke BSTR yang mewakili nama tampilan properti. Setelah Anda selesai menggunakan BSTR, bebaskan dengan memanggil fungsi SysFreeString .

Nilai kembali

C++

Jika metode berhasil, metode mengembalikan S_OK.

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

VB

Nilai yang dikembalikan adalah String yang berisi nama tampilan properti.

Keterangan

Fungsionalitas metode GetCAPropertyDisplayName mirip dengan metode ICertAdmin2::GetCAPropertyDisplayName .

Dalam metode ICertAdmin2, CA memberlakukan bahwa pemanggil memiliki akses baca CA, yang biasanya hanya diberikan kepada petugas CA dan administrator CA.

Sebaliknya, dalam implementasi metode ICertRequest2 dan ICertRequest3, CA tidak memerlukan hak akses apa pun secara default. Hanya daftar kontrol akses (ACL) Model Objek Komponen Terdistribusi (DCOM) yang diberlakukan; untuk CA yang bergabung dengan domain, ACL DCOM memungkinkan Semua Orang mengakses CA. Semua orang tidak menyertakan Anonim. Antarmuka permintaan CA dapat dikunci dengan menggunakan konfigurasi registri untuk memberlakukan bahwa pemanggil memiliki akses pendaftaran.

Persyaratan

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