Bagikan melalui

Metode ICertificateEnrollmentPolicyServerSetup::SetProperty (casetup.h)

  • Artikel

Metode SetProperty menentukan nilai enumerasi CEPSetupProperty untuk konfigurasi Layanan Web Kebijakan Pendaftaran Sertifikat (CEP).

Sintaks

HRESULT SetProperty(
  [in] CEPSetupProperty propertyId,
  [in] VARIANT          *pPropertyValue
);

Parameter

[in] propertyId

Nilai enumerasi CEPSetupProperty yang menentukan nilai properti yang akan ditetapkan. Nilai berikut ini valid.

Nilai Deskripsi
ENUM_CEPSETUPPROP_AUTHENTICATION Parameter pPropertyValue berisi nilai yang mengidentifikasi jenis autentikasi yang akan digunakan.
ENUM_CEPSETUPPROP_SSLCERTHASH Parameter pPropertyValue berisi hash sertifikat, jika ada, yang digunakan selama autentikasi. ENUM_CEPSETUPPROP_AUTHENTICATION harus diatur ke X509AuthCertificate.
ENUM_CEPSETUPPROP_KEYBASED_RENEWAL Parameter pPropertyValue menentukan apakah akan menyiapkan Server Kebijakan Pendaftaran dalam mode yang mengembalikan kebijakan hanya untuk templat KeyBasedRenewal.
ENUM_CEPSETUPPROP_URL Anda tidak dapat menentukan nilai ini.

[in] pPropertyValue

Penunjuk ke variabel VARIAN yang berisi nilai properti.

Jika Anda menentukan ENUM_CEPSETUPPROP_AUTHENTICATION dalam parameter propertyId , subjenis VARIAN harus VT_I2, VT_I4 atau VT_UII4, dan argumen pPropertyValue harus merupakan salah satu konstanta berikut:

  • X509AuthKerberos
  • X509AuthUsername
  • X509AuthCertificate

Jika Anda menentukan ENUM_CEPSETUPPROP_SSLCERTHASH dalam parameter propertyId , Anda harus mengatur parameter pPropertyValue ke subjenis VT_BSTR yang berisi hash sertifikat yang digunakan untuk autentikasi.

Jika Anda menentukan ENUM_CEPSETUPPROP_AUTHENTICATION dalam parameter propertyId , parameter pPropertyValue berisi prosedur autentikasi.

Jika Anda menentukan ENUM_CEPSETUPPROP_URL dalam parameter propertyId , parameter pPropertyValue berisi URL Layanan Web Kebijakan Pendaftaran Sertifikat (CEP).

Jika Anda menentukan ENUM_CEPSETUPPROP_KEYBASED_RENEWAL dalam parameter propertyId , Anda harus mengatur parameter pPropertyValue ke subjenis VT_BOOL yang menunjukkan apakah akan menyiapkan Server Kebijakan Pendaftaran dalam mode yang mengembalikan kebijakan hanya untuk templat KeyBasedRenewal.

Mengembalikan nilai

Menampilkan kode Deskripsi
E_INVALIDARG
 Argumen propertyId bukan anggota jenis enumerasi CEPSetupProperty atau Anda telah mencoba mengatur nilai ENUM_CEPSETUPPROP_URL .
E_POINTER
 Parameter pPropertyValue tidak boleh NULL.
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
 Objek ICertificateEnrollmentPolicyServerSetup belum diinisialisasi.

Nilai properti ErrorString diatur ke "Objek penyiapan belum diinisialisasi. Harap inisialisasi objek penyiapan dengan metode InitializeInstallDefaults."
HRESULT_FROM_WIN32(ERROR_CLUSTER_PROPERTY_DATA_TYPE_MISMATCH)
 Jika Anda mengatur properti ENUM_CEPSETUPPROP_AUTHENTICATION , subjenis VARIAN harus VT_I2, VT_I4, atau VT_UI4.

Keterangan

Anda harus memanggil InitializeInstallDefaults sebelum memanggil metode SetProperty .

Persyaratan

   
Klien minimum yang didukung Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform Windows
Header casetup.h
DLL Certocm.dll

Lihat juga

Getproperty

ICertificateEnrollmentPolicyServerSetup

InitializeInstallDefaults