Compartir a través de

  • Artículo

Método CreateSSLCertificateBinding (MSReportServer_ConfigurationSetting de WMI)

Crea un enlace de certificado 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

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

  • CertificateHash
    Valor hash del certificado.

  • IPAddress
    Dirección IP para la aplicación.

  • Port
    Puerto SSL 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 ahí.

Antes de crear el enlace, la llamada al método examina las reservas de direcciones URL para la aplicación especificada con el fin de determinar si el enlace de certificado 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: raíz\Microsoft\SqlServer\servidorDeInformes\RS_<nombreDeInstanciaCodificado>\v10\Admin

Plataforma: Windows Server 2003, Datacenter Edition; Windows Server 2003, Enterprise Edition; Windows Server 2003, Standard Edition; Windows Vista; Windows XP Professional con Service Pack 2 (SP2) o Service Pack 1 (SP1) o Windows 2000 (todas las versiones)