通过

ConfigurationSetting 方法 - CreateSSLCertificateBinding

  • 项目

创建 TLS/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);

参数

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

CertificateHash
证书的哈希。 certificateHash 应该是小写哈希。 如果哈希包含大写字符，则会失败。

IPAddress
应用程序的 IP 地址。

端口
与绑定关联的 TLS 端口。

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

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

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

返回值

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

注解

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

在创建绑定前，此方法调用会检查指定应用程序的 URL 预留，以确定 TLS/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\<InstanceName>\v13\Admin

相关内容