通过

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)
Library Certidl.lib

另请参阅

ICertConfig

ICertManageModule