ICertManageModule：：SetProperty 方法 (certmod.h)

项目
02/23/2024

SetProperty 方法允许模块设置属性值。

语法

HRESULT SetProperty(
  [in] const BSTR    strConfig,
  [in] BSTR          strStorageLocation,
  [in] BSTR          strPropertyName,
  [in] LONG          Flags,
  [in] const VARIANT *pvarProperty
);

参数

[in] strConfig

表示证书服务服务器的配置字符串，格式为 COMPUTERNAME\CANAME，其中 COMPUTERNAME 是证书服务服务器的网络名称，CANAME 是证书颁发机构 (CA) 的公用名称，如在证书服务设置期间为 CA 输入。有关配置字符串名称的信息，请参阅 ICertConfig。

[in] strStorageLocation

为属性值提供存储的位置，如 ICertManageModule：：GetProperty 中 strStorageLocation 的定义中所述。

[in] strPropertyName

要分配其值的属性的名称。策略和退出模块应支持证书服务管理器使用的以下属性。

值	含义
名称 - **	模块的名称。
说明	模块的说明。
版权	与模块相关的版权。
文件版本	模块文件的版本。
产品版本	模块的版本。

[in] Flags

此参数是保留的，必须设置为零。

[in] pvarProperty

要分配给 strPropertyName 指定的属性的值。

返回值

VB

如果该方法成功，该方法将返回S_OK。

如果方法失败，它将返回指示错误的 HRESULT 值。有关常见错误代码的列表，请参阅常见 HRESULT 值。

注解

此方法适用于将来的功能。但是，需要最小实现来满足 ICertManageModule 接口的要求。

示例

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

HRESULT CCertManagePolicyModule::SetProperty(
            /* [in] */ const BSTR strConfig,
            /* [in] */ BSTR strStorageLocation,
            /* [in] */ BSTR strPropertyName,
            /* [in] */ LONG Flags,
            /* [in] */ const VARIANT *pvarProperty)
{
    // This implementation fulfills the minimal requirement
    // needed for ICertManageModule::SetProperty.
    return S_OK;
}

要求

要求	值
最低受支持的客户端	无受支持的版本
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	certmod.h (包括 Certsrv.h)
Library	Certidl.lib