Metode ICertAdmin2::SetCAProperty (certadm.h)

Artikel
07/16/2024

Metode SetCAProperty menetapkan nilai properti untuk otoritas sertifikasi (CA) .

Sintaksis

HRESULT SetCAProperty(
  [in] const BSTR strConfig,
  [in] LONG       PropId,
  [in] LONG       PropIndex,
  [in] LONG       PropType,
  [in] VARIANT    *pvarPropertyValue
);

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.

PentingSetCAProperty 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] PropId

Menentukan salah satu pengidentifikasi properti berikut.

Untuk informasi tentang semua properti CA, termasuk properti baca-saja, lihat ICertAdmin2::GetCAProperty.

Nilai	Arti
CR_PROP_KRACERT	Sertifikat agen pemulihan kunci (KRA) CA. Format data: biner, terindeks.
CR_PROP_KRACERTCOUNT	Jumlah sertifikat KRA untuk CA. Format data: Long.
CR_PROP_KRACERTUSEDCOUNT	Jumlah sertifikat KRA yang digunakan oleh CA. Format data: Long.
CR_PROP_ROLESEPARATIONENABLED	Nilai yang menentukan apakah pemisahan peran diaktifkan. Format data: Long.
CR_PROP_TEMPLATES	Daftar templat yang didukung oleh CA. Format data: String.

[in] PropIndex

Jika parameter propId diindeks, indeks berbasis nol yang akan digunakan saat mengambil nilai properti. Jika PropId tidak diindeks, nilai ini diabaikan.

[in] PropType

Menentukan jenis properti. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Arti
PROPTYPE_LONG	Data Panjang yang ditandatangani.
PROPTYPE_DATE	Tanggal/Waktu (dicadangkan untuk penggunaan di masa mendatang).
PROPTYPE_BINARY	Data biner.
PROPTYPE_STRING	data StringUnicode.

[in] pvarPropertyValue

C++	Penunjuk ke VARIAN yang menentukan nilai properti.
VB	Varian yang menentukan nilai properti.

Mengembalikan nilai

VB

Jika fungsi berhasil, nilai yang dikembalikan adalah S_OK.

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

Persyaratan

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

Lihat juga

ICertAdmin2

ICertAdmin2::GetCAProperty

Bagikan melalui