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(주기적으로 변경)입니다. 대신 Wild카드 IP 주소를 사용합니다(0.0.0.0).

  4. 지정된 IPAddress가 URL 예약의 IP 주소와 일치하지 않으며 야생카드 호스트 이름 URL 예약이 있습니다.

  5. 호스트 이름을 지정하는 URL 예약이 있지만 호스트 이름이 인증서 호스트 이름과 일치하지 않습니다.

요구 사항

네임스페이스:root\Microsoft\SqlServer\ReportServer\<InstanceName>\v13\Admin

MSReportServer_ConfigurationSetting 멤버