分享方式：

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 保留項目存在，但是此主機名稱與憑證主機名稱不符。

需求

Namespace: root\Microsoft\SqlServer\ReportServer\<InstanceName>\v13\Admin

相關內容

MSReportServer_ConfigurationSetting 成員