Metode ICertAdmin2::GetConfigEntry (certadm.h)

Artikel
02/23/2024

Metode GetConfigEntry mengambil informasi konfigurasi untuk otoritas sertifikasi (CA).

Sintaks

HRESULT GetConfigEntry(
  [in]  const BSTR strConfig,
  [in]  const BSTR strNodePath,
  [in]  const BSTR strEntryName,
  [out] VARIANT    *pvarEntry
);

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. Parameter ini bisa menjadi string kosong, dalam hal ini fungsi mengambil informasi konfigurasi yang tidak spesifik untuk CA. Parameter ini tidak boleh NULL.

GetConfigEntrypenting 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.

[in] strNodePath

Nilai string yang mewakili jalur simpul untuk informasi konfigurasi. Parameter ini dapat berupa string kosong, dalam hal ini fungsi mengambil informasi konfigurasi dari jalur yang diidentifikasi oleh strConfig. Parameter ini tidak boleh NULL.

[in] strEntryName

Nilai string yang mewakili nama entri yang informasinya sedang diambil. Nilai ini bisa menjadi string kosong, dalam hal ini semua nama entri diambil. Parameter ini tidak boleh NULL.

[out] pvarEntry

Pointer ke VARIAN yang menerima informasi yang diminta.

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 Varian yang mewakili informasi konfigurasi yang diambil.

Keterangan

Informasi konfigurasi disimpan di registri di bawah jalur berikut.

\ HKEY_LOCAL_MACHINESISTEM\CurrentControlSet\Layanan\CertSvc\Konfigurasi\[CASANITIZEDNAME]\[strNodePath]\[strEntryName]

Di mana CASANITIZEDNAME adalah nama sanitasi untuk CA. Untuk informasi selengkapnya tentang nama yang dibersamakan, lihat ICertConfig2::GetConfig.

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	certadm.h (termasuk Certsrv.h)
Pustaka	Certidl.lib
DLL	Certadm.dll

Lihat juga

ICertAdmin2

Bagikan melalui