Bagikan melalui

Metode ICertificateEnrollmentServerSetup::InitializeInstallDefaults (casetup.h)

  • Artikel

Metode InitializeInstallDefaults menginisialisasi objek ICertificateEnrollmentServerSetup dengan konfigurasi default.

Sintaks

HRESULT InitializeInstallDefaults();

Mengembalikan nilai

Menampilkan kode Deskripsi
E_ACCESSDENIED
 Pengguna harus menjadi administrator akar domain atau perusahaan. Komputer harus digabungkan ke domain.

Jika pengguna bukan akar domain atau administrator perusahaan, properti ErrorString diatur ke:

"Anda harus menjadi anggota grup Admin Perusahaan untuk menjalankan Penyetelan."

Jika komputer tidak bergabung ke domain, properti ErrorString diatur ke:

"Layanan Web Pendaftaran Sertifikat atau Layanan Web Kebijakan Pendaftaran Sertifikat tidak dapat diinstal pada komputer yang bukan anggota domain."
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
 Objek ICertificateEnrollmentServerSetup telah diinisialisasi. Properti ErrorString diatur ke:

"Objek penyiapan telah diinisialisasi. Objek ini tidak dapat diinisialisasi lebih dari sekali."

Keterangan

Metode ini melakukan tindakan berikut:

  • Menentukan apakah objek ICertificateEnrollmentServerSetup telah diinisialisasi.
    Catatan Jika pemeriksaan ini gagal, metode mengatur properti ErrorString ke "Objek penyiapan telah diinisialisasi. Objek ini tidak dapat diinisialisasi lebih dari sekali."
     
  • Menentukan apakah pengguna adalah administrator akar domain atau perusahaan.
    Catatan Jika pemeriksaan ini gagal, metode mengatur properti ErrorString ke "Anda harus menjadi anggota grup Admin Perusahaan untuk menjalankan Penyetelan."
     
  • Menentukan apakah komputer bergabung ke domain.
    Catatan Jika pemeriksaan ini gagal, metode mengatur properti ErrorString ke "Layanan Web Pendaftaran Sertifikat atau Layanan Web Kebijakan Pendaftaran Sertifikat tidak dapat diinstal pada komputer yang bukan anggota domain."
     
  • Mengatur prosedur autentikasi default ke Kerberos. Anda dapat memanggil SetProperty untuk mengubah metode autentikasi.
  • Menentukan apakah CES diinstal pada komputer yang menjalankan Windows Server 2008 R2.
    Catatan Jika pemeriksaan ini gagal, metode mengatur properti ErrorString ke "Layanan Web Pendaftaran Sertifikat atau Layanan Web Kebijakan Pendaftaran Sertifikat harus diinstal pada server anggota di forest Direktori Aktif tempat ADPrep /forestprep versi Windows Server 2008 R2 berhasil dijalankan."
     
  • Mengatur konteks server default ke akun bawaan ApplicationPoolIdentity .
  • Mengatur properti ENUM_CESSETUPPROP_RENEWALONLY ke FALSE.
  • Mengatur properti ENUM_CESSETUPPROP_URL adalah ke "https:// computerDNSname/SanitizedCAShortName_CES_Kerberos/service.svc/ces" jika ada konfigurasi otoritas sertifikasi (CA) yang valid. Jika konfigurasi yang valid tidak ada, properti ENUM_CESSETUPPROP_URL tidak diatur. SanitizedCAShortName adalah nama pendek CA yang dibersamakan. Untuk informasi selengkapnya tentang nama yang dibersikan, lihat GetConfig.
    Catatan Jika otoritas sertifikasi adalah CA mandiri, properti ErrorString diatur ke "Layanan Web Pendaftaran Sertifikat tidak dapat digunakan dengan otoritas sertifikasi mandiri (CA). Ini hanya dapat digunakan dengan OS perusahaan."
     
Anda harus memanggil metode InitializeInstallDefaults sebelum memanggil metode apa pun selain UnInstall. Panggil metode Instal untuk menginstal layanan yang dikonfigurasi. Panggil UnInstall pada objek ICertificateEnrollmentServerSetup baru untuk menghapus layanan.

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

CESSetupProperty

ICertificateEnrollmentServerSetup