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);
パラメーター
Application
証明書のバインドを作成する必要があるアプリケーションの名前。
CertificateHash
証明書のハッシュ。 certificateHash は小文字のハッシュを想定しています。 ハッシュに大文字が含まれている場合は失敗します。
IPAddress
アプリケーションの IP アドレス。
[ポート]
バインドに関連付けられた TLS ポート。
Lcid
返されるエラー メッセージに使用するロケール。
Error
[out] 発生したエラーの説明。
HRESULT
[out] 呼び出しの成功または失敗を示す値。
戻り値
メソッド呼び出しの成功または失敗を示す HRESULT を返します。 値が 0 の場合はメソッド呼び出しが正常に完了したことを示します。エラー コードの場合は呼び出しが失敗したことを示します。
解説
このメソッドは、アプリケーションの rsreportserver.config にバインドを追加します。 バインドが HTTP.SYS に存在しない場合は作成されます。
バインドを作成する前に、メソッドの呼び出しによって、指定されたアプリケーションの URL 予約が調査され、TLS/SSL 証明書のバインドが有効かどうかが確認されます。
次の条件が検証されて、その結果エラーが発生する場合があります。
証明書が存在しない。
指定された IP アドレスがこのコンピューターの IP アドレスと一致しない。
指定された IP アドレスが DHCP の IP アドレス (定期的に変更される) であるため、代わりにワイルドカードの IP アドレス (0.0.0.0) が使用されている。
指定された IP アドレスが URL 予約の IP アドレスと一致せず、ワイルドカードまたはホスト名の URL 予約も存在しない。
ホスト名を指定する URL 予約は存在するが、ホスト名が証明書のホスト名と一致しない。
要件
名前空間: root\Microsoft\SqlServer\ReportServer\<InstanceName>\v13\Admin