ICertManageModule：：Configure 方法 (certmod.h)

Configure 方法會顯示模組用戶介面。

語法

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

參數

[in] strConfig

代表憑證服務伺服器的組態字串，格式為 COMPUTERNAME\CANAME，其中 COMPUTERNAME 是證書服務伺服器網路名稱，CANAME 是 證書頒發機構單位 的一般名稱， (CA 在憑證服務設定期間輸入 CA) 。 如需設定字串名稱的相關信息，請參閱 ICertConfig。

[in] strStorageLocation

提供屬性值記憶體的位置，如 ICertManageModule：：GetProperty 中的 strStorageLocation 定義中所述。

[in] Flags

值，用來判斷是否要向用戶呈現組態介面。 如果此值為零，則會向用戶顯示用來設定模組的介面。 如果此值是CMM_REFRESHONLY，憑證服務將不會顯示使用者介面，但在處理未來的憑證要求時，模組設定的最新變更將會生效， (這樣可讓變更納入，而不需要回應使用者介面) 。

傳回值

VB

如果方法成功，方法會傳回S_OK。

如果方法失敗，它會傳回指出錯誤的 HRESULT 值。 如需常見錯誤碼的清單，請參閱 一般 HRESULT 值。

備註

Configure 方法會顯示模組使用者介面，如果存在) (，這可讓用戶檢視和變更模組的可設定專案。 實作 ICertManageModule 的模組可以在 [憑證服務管理員原則] 或 [結束模組] 屬性頁作用中且使用者選擇 [設定] 按鈕時呼叫其 Configure 方法。 憑證服務管理員會將 strStorageLocation 參考的位置傳遞至此課程模組，然後此方法的實作可以視需要使用這個位置。 請注意，模組可能沒有可設定的專案 (因此，使用者介面不需要) ，但仍需要實作此方法。 下列範例不允許用戶進行設定變更，但會實作此方法。

範例

#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;
}

規格需求

需求	值
最低支援的用戶端	都不支援
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	certmod.h (包含 Certsrv.h)
程式庫	Certidl.lib

另請參閱

ICertConfig

ICertManageModule