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
構成インターフェイスをユーザーに表示するかどうかを決定するために使用される値。 この値が 0 の場合、モジュールを構成するためのインターフェイスがユーザーに表示されます。 この値がCMM_REFRESHONLYの場合、Certificate Services はユーザー インターフェイスを表示しませんが、モジュールの構成に対する最新の変更は、将来の証明書要求が処理されるときに有効になります (これにより、ユーザー インターフェイスへの応答を必要とせずに変更を組み込むことができます)。
戻り値
VB
メソッドが成功した場合、メソッドは S_OKを返します。メソッドが失敗した場合は、エラーを示す HRESULT 値を返します。 一般的なエラー コードの一覧については、「 共通 HRESULT 値」を参照してください。
注釈
Configure メソッドは、モジュールのユーザー インターフェイス (存在する場合) を表示します。これにより、ユーザーはモジュールの構成可能な項目を表示および変更できます。 ICertManageModule を実装するモジュールでは、Certificate Services Manager ポリシーまたは Exit Module プロパティ ページがアクティブで、ユーザーが [構成] ボタンを選択したときに、その Configure メソッドを呼び出すことができます。 Certificate Services Manager は 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 を含む) |
| Library | Certidl.lib |