• 项目

CreateSSLCertificateBinding 方法 (WMI MSReportServer_ConfigurationSetting)

创建 SSL 证书绑定。

语法

Public Sub CreateSSLCertificateBinding(ByVal Application As String, _
    ByVal CertificateHash As String, ByVal IPAddress As String, _
    ByVal Port As Int32, ByVal lcid As Int32, _
    ByRef [Error] As String, ByRef HRESULT As Int32)

public void CreateSSLCertificateBinding(string application, 
    string certificateHash, string IPAddress, int Port, 
    int lcid, out string error, out int HRESULT);

参数

  • Application
    应为其创建证书绑定的应用程序的名称。

  • CertificateHash
    证书的哈希。

  • IPAddress
    应用程序的 IP 地址。

  • Port
    与该绑定关联的 SSL 端口。

  • Lcid
    用于返回的错误消息的区域设置。

  • Error
    [out] 发生的错误的说明。

  • HRESULT
    [out] 指示调用是成功还是失败的值。

返回值

返回 HRESULT，指示方法调用是成功还是失败。值 0 指示方法调用已成功；错误代码指示调用未成功。

注释

此方法将向 rsreportserver.config 中为该应用程序添加一个绑定。如果某个绑定在 HTTP.SYS 中不存在，则会在其中创建它。

在创建绑定之前，该方法调用会检查指定应用程序的 Url 保留项，以确定 SSL 证书绑定是否有效。

如果验证到存在以下情况，则会导致错误：

  1. 证书不存在。

  2. 指定的 IPAddress 与此计算机的 IPAddress 不对应。

  3. 指定的 IPAddress 为 DHCP IPAddress（定期更改）– 请改用通配符 IP 地址 (0.0.0.0)。

  4. 指定的 IPAddress 与某个 URL 保留项的 IP 地址不匹配，并且没有通配符或主机名 URL 保留项。

  5. 指定某个主机名的 URL 保留项已存在，但是该主机名与证书主机名不匹配。

要求

命名空间： root\Microsoft\SqlServer\ReportServer\RS_<EncodedInstanceName>\v10\Admin

平台： Windows Server 2003 Datacenter Edition；Windows Server 2003 Enterprise Edition；Windows Server 2003 Standard Edition；Windows Vista；Windows XP Professional Service Pack 2 (SP2) 或 Service Pack 1 (SP1) 或者 Windows 2000（所有版本）