Método ConfigurationSetting - CreateSSLCertificateBinding

Crea un enlace de certificado TLS/SSL.

Sintaxis

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);  

Parámetros

Aplicación
Nombre de la aplicación para la que se debe crear el enlace de certificado.

CertificateHash
Valor hash del certificado. CertificateHash espera un hash en minúsculas. Si el hash contiene caracteres en mayúsculas, se produce un error.

IPAddress
Dirección IP para la aplicación.

Puerto
Puerto TLS asociado al enlace.

Lcid
Configuración regional que se utilizará para los mensajes de error devueltos.

Error
[out] Descripción de los errores que se produjeron.

HRESULT
[out] Valor que indica si la llamada se realizó correctamente o no.

Valor devuelto

Devuelve HRESULT que indica si la llamada al método se realizó correctamente o no. Un valor de 0 indica que la llamada al método se realizó correctamente; un código de error indica que la llamada no se realizó correctamente.

Comentarios

Este método agrega un enlace a rsreportserver.config para la aplicación. Si no existe todavía un enlace en HTTP.SYS, se crea uno ahí.

Antes de crear el enlace, la llamada de método examina las reservas de direcciones URL para la aplicación especificada con el fin de determinar si el enlace de certificado TLS/SSL es válido.

Las condiciones siguientes se validan y pueden dar lugar a errores:

1. El certificado no existe.

2. La dirección IP especificada no corresponde a una dirección IP de este equipo.

3. La dirección IP especificada es una dirección IP para DHCP (cambia periódicamente): en su lugar, use la dirección IP con un carácter comodín (0.0.0.0).

4. La dirección IP especificada no coincide con la dirección IP de una reserva de dirección URL y no existe una reserva de dirección URL de nombre de host o con un carácter comodín.

5. Existe una reserva de dirección URL que especifica un nombre de host, pero el nombre de host no coincide con el nombre de host del certificado.

Requisitos

Espacio de nombres:root\Microsoft\SqlServer\ReportServer\<nombreDeInstancia>\v13\Admin

Contenido relacionado

Miembros MSReportServer_ConfigurationSetting