Bagikan melalui

ICertificateEnrollmentPolicyServerSetup::Metode GetProperty (casetup.h)

  • Artikel

Metode GetProperty mengambil nilai enumerasi CEPSetupProperty untuk konfigurasi Layanan Web Kebijakan Pendaftaran Sertifikat (CEP).

Sintaks

HRESULT GetProperty(
  [in]  CEPSetupProperty propertyId,
  [out] 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_KEYBASED_RENEWAL Parameter pPropertyValue menentukan apakah akan menyiapkan Server Kebijakan Pendaftaran dalam mode yang mengembalikan kebijakan hanya untuk templat KeyBasedRenewal.
ENUM_CEPSETUPPROP_URL Berisi URL layanan CEP. Jika metode GetProperty berhasil dikembalikan, argumen pPropertyValue akan berisi subjenis VT_BSTR yang berisi URL formulir "https:// computerDNSname/ADPolicyProvider_cep_AuthenticationType/service.svc/cep" di mana jenis autentikasi dapat berupa salah satu hal berikut:
  • Kerberos
  • usernamepassword
  • sertifikat

[out] pPropertyValue

Penunjuk ke variabel VARIAN yang berisi nilai properti.

Jika Anda menentukan ENUM_CEPSETUPPROP_AUTHENTICATION dalam parameter propertyId , parameter pPropertyValue akan berisi salah satu konstanta berikut jika metode GetProperty berhasil dikembalikan:

  • X509AuthKerberos
  • X509AuthUsername
  • X509AuthCertificate

Jika Anda menentukan ENUM_CEPSETUPPROP_SSLCERTHASH dalam parameter propertyId , parameter pPropertyValue akan berisi subjenis VT_BSTR yang berisi hash jika metode GetProperty berhasil dikembalikan.

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.

Nilai kembali

Menampilkan kode Deskripsi
E_INVALIDARG
 Argumen propertyId bukan anggota jenis enumerasi CEPSetupProperty .
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. Silakan inisialisasi objek penyiapan dengan metode InitializeInstallDefaults."

Persyaratan

Persyaratan Nilai
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

ICertificateEnrollmentPolicyServerSetup

InitializeInstallDefaults

SetProperty