Metode ICertAdmin2::GetMyRoles (certadm.h)

Artikel
03/14/2023

Metode GetMyRoles mengambil peran otoritas sertifikasi (CA) dari pemanggil.

Sintaks

HRESULT GetMyRoles(
  [in]  const BSTR strConfig,
  [out] LONG       *pRoles
);

Parameter

[in] strConfig

Nilai string yang 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.

GetMyRolespenting tidak menghapus cache internal saat string konfigurasi diubah. Saat Anda mengubah string konfigurasi untuk CA, Anda harus membuat instans objek ICertAdmin baru dan memanggil metode ini lagi dengan string konfigurasi baru.

[out] pRoles

Penunjuk ke nilai LONG yang mewakili peran CA yang diambil untuk pemanggil. Ini bisa menjadi kombinasi bitwise dari nol atau lebih dari nilai berikut.

Nilai	Makna
CA_ACCESS_ADMIN 0x1	Penelepon memiliki kemampuan administrator CA.
CA_ACCESS_AUDITOR 0x4	Penelepon memiliki kemampuan auditor CA.
CA_ACCESS_ENROLL 0x200	Penelepon memiliki akses pendaftaran.
CA_ACCESS_OFFICER 0x2	Penelepon memiliki kemampuan petugas CA.
CA_ACCESS_OPERATOR 0x8	Penelepon memiliki kemampuan pencadangan CA.
CA_ACCESS_READ 0x100	Penelepon memiliki akses baca CA.

Nilai kembali

C++

Jika fungsi berhasil, nilai yang dikembalikan adalah S_OK.

Jika fungsi gagal, nilai yang dikembalikan adalah HRESULT yang menunjukkan kesalahan. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.

VB

Nilai yang dikembalikan adalah nilai Panjang yang mewakili peran CA yang diambil untuk pemanggil. Ini bisa menjadi kombinasi bitwise dari nol atau lebih dari nilai berikut.

Mengembalikan kode/nilai	Deskripsi
CA_ACCESS_ADMIN 0x1	Penelepon memiliki kemampuan administrator CA.
CA_ACCESS_AUDITOR 0x4	Penelepon memiliki kemampuan auditor CA.
CA_ACCESS_ENROLL 0x200	Penelepon memiliki akses pendaftaran.
CA_ACCESS_OFFICER 0x2	Penelepon memiliki kemampuan petugas CA.
CA_ACCESS_OPERATOR 0x8	Penelepon memiliki kemampuan pencadangan CA.
CA_ACCESS_READ 0x100	Penelepon memiliki akses baca.

Persyaratan


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

Lihat juga

ICertAdmin2

Bagikan melalui