Metode ICertAdmin2::SetConfigEntry (certadm.h)

Metode SetConfigEntry menetapkan informasi konfigurasi untuk otoritas sertifikasi (CA).

Sintaks

HRESULT SetConfigEntry(
  [in] const BSTR strConfig,
  [in] const BSTR strNodePath,
  [in] const BSTR strEntryName,
  [in] 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 mengatur informasi konfigurasi yang tidak spesifik untuk CA. Parameter ini tidak boleh NULL.

SetConfigEntrypenting 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 ditetapkan. Nilai ini bisa menjadi string kosong, dalam hal ini entri default adalah entri yang sedang diatur. Parameter ini tidak boleh NULL.

[in] pvarEntry

C++	Penunjuk ke VARIAN yang menentukan informasi yang akan diatur. Jika nilai ini kosong, maka kunci yang ditunjukkan akan dihapus.
VB	Varian yang menentukan informasi yang akan diatur. Jika nilai ini kosong, maka kunci yang ditunjukkan akan dihapus.

Mengembalikan nilai

VB

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.

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

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