ICertManageModule::Konfigurasikan metode (certmod.h)

Metode Konfigurasi menampilkan antarmuka pengguna modul.

Sintaks

HRESULT Configure(
  [in] const BSTR strConfig,
  [in] BSTR       strStorageLocation,
  [in] LONG       Flags
);

Parameter

[in] strConfig

Mewakili string konfigurasi untuk server Layanan Sertifikat dalam bentuk COMPUTERNAME\CANAME, di mana COMPUTERNAME adalah nama jaringan server Certificate Services, dan CANAME adalah nama umum otoritas sertifikasi (CA) seperti yang dimasukkan untuk CA selama penyiapan Layanan Sertifikat. Untuk informasi tentang nama string konfigurasi, lihat ICertConfig.

[in] strStorageLocation

Lokasi yang menyediakan penyimpanan untuk nilai properti, seperti yang dijelaskan dalam definisi strStorageLocation di ICertManageModule::GetProperty.

[in] Flags

Nilai yang digunakan untuk menentukan apakah antarmuka konfigurasi akan disajikan kepada pengguna. Jika nilai ini nol, pengguna akan disajikan dengan antarmuka untuk mengonfigurasi modul. Jika nilai ini CMM_REFRESHONLY, Layanan Sertifikat tidak akan menampilkan antarmuka pengguna, tetapi perubahan terbaru pada konfigurasi modul akan berlaku ketika permintaan sertifikat di masa mendatang diproses (ini memungkinkan perubahan untuk dimasukkan tanpa memerlukan respons terhadap antarmuka pengguna).

Nilai kembali

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.

Keterangan

Metode Konfigurasi menampilkan antarmuka pengguna modul (jika ada), yang memungkinkan pengguna untuk melihat dan mengubah item modul yang dapat dikonfigurasi. Modul yang mengimplementasikan ICertManageModule dapat memiliki metode Konfigurasi yang dipanggil saat halaman properti Kebijakan Pengelola Layanan Sertifikat atau Modul Keluar aktif dan pengguna memilih tombol Konfigurasi . Manajer Layanan Sertifikat akan meneruskan lokasi yang dirujuk oleh strStorageLocation ke modul ini, dan implementasi metode ini kemudian dapat menggunakan lokasi ini sesuai kebutuhan. Perhatikan bahwa ada kemungkinan bahwa modul mungkin tidak memiliki item yang dapat dikonfigurasi (oleh karena itu, antarmuka pengguna tidak akan diperlukan), tetapi masih perlu untuk menerapkan metode ini. Contoh di bawah ini tidak memungkinkan pengguna untuk membuat perubahan konfigurasi, tetapi menerapkan metode ini.

Contoh

#include <windows.h>
#include <Certmod.h>

HRESULT CCertManagePolicyModule::Configure( 
            /* [in] */ const BSTR strConfig,
            /* [in] */ BSTR strStorageLocation,
            /* [in] */ LONG Flags)
{
    if ( CMM_REFRESHONLY != Flags )
        MessageBox(NULL,
                   L"This module has no configurable items",
                   L"MyModule",
                   (MB_OK|MB_ICONINFORMATION));

    return S_OK;
}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tidak ada yang didukung
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	certmod.h (termasuk Certsrv.h)
Pustaka	Certidl.lib

Lihat juga

ICertConfig

ICertManageModule