Bagikan melalui


Metode IOCSPAdmin::GetConfiguration (certadm.h)

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