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

こちらもご覧ください

ICertConfig

ICertManageModule