Metode IOCSPAdmin::GetConfiguration (certadm.h)

Artikel
03/14/2023

Metode GetConfiguration tersambung ke server responden Protokol Status Sertifikat Online (OCSP) dan menginisialisasi objek OCSPAdmin dengan informasi konfigurasi dari server.

Sintaks

HRESULT GetConfiguration(
  [in] const BSTR   bstrServerName,
  [in] VARIANT_BOOL bForce
);

Parameter

[in] bstrServerName

String yang berisi nama responden-server.

[in] bForce

C++	VARIANT_TRUE jika penelepon ingin membaca konfigurasi responden dari registri server saat instans layanan responden OCSP yang sedang berjalan tidak dapat ditemukan; jika tidak, VARIANT_FALSE.
VB	Benar jika penelepon ingin membaca konfigurasi responden dari registri server saat instans layanan responden OCSP yang sedang berjalan tidak dapat ditemukan; jika tidak, False.

Menampilkan nilai

VB

Jika metode berhasil, metode akan mengembalikan S_OK.

Jika metode gagal, metode mengembalikan nilai HRESULT yang menunjukkan kesalahan. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.

Jika metode mengembalikan HRESULT_FROM_WIN32(ERROR_INVALID_STATE), konfigurasi sudah diinisialisasi.

Jika metode mengembalikan E_INVALIDARG, parameter pVal diatur ke NULL.

Keterangan

Tabel berikut mencantumkan efek nilai parameter bForce pada panggilan metode.

Layanan responden OCSP di server target	bForceVARIANT_TRUE	bForceVARIANT_FALSE
Berjalan	Ambil konfigurasi dari layanan.	Ambil konfigurasi dari layanan.
Dihentikan	Coba ambil konfigurasi dari registri server. Jika upaya ini gagal, kembalikan kesalahan.	Mengembalikan kesalahan.

Tabel berikut mencantumkan efek nilai parameter bForce pada panggilan metode.

Layanan responden OCSP di server target	bForce adalah True	bForce adalah False
Berjalan	Ambil konfigurasi dari layanan.	Ambil konfigurasi dari layanan.
Dihentikan	Coba ambil konfigurasi dari registri server. Jika upaya ini gagal, kembalikan kesalahan.	Mengembalikan kesalahan.

Metode ini mencoba membaca konfigurasi dari instans yang berjalan dari layanan responden OCSP, tetapi itu mungkin tidak dimungkinkan jika layanan tidak berjalan atau dalam keadaan tidak dapat diakses. Pemanggil dapat menginstruksikan metode untuk membaca konfigurasi dari registri server jika instans yang sedang berjalan tidak dapat ditemukan.

Metode gagal jika Anda mencoba memanggilnya lebih dari sekali untuk objek OCSPAdmin tertentu. Setiap instans OCSPAdmin sesuai dengan satu server responden. Untuk menyambungkan ke server lain dalam array server responden OCSP, buat instans baru objek OCSPAdmin .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tidak ada yang didukung
Server minimum yang didukung	Pusat Data Windows Server 2008, Windows Server 2008 Enterprise [hanya aplikasi desktop]
Target Platform	Windows
Header	certadm.h (termasuk Certsrv.h)
Pustaka	Certadm.lib
DLL	Certadm.dll

Lihat juga

IOCSPAdmin

Share via