• Article

Méthode CreateSSLCertificateBinding (WMI MSReportServer_ConfigurationSetting)

Crée une liaison de certificat SSL.

Syntaxe

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

Paramètres

  • Application
    Nom de l'application pour laquelle la liaison de certificat doit être créée.

  • CertificateHash
    Hachage du certificat.

  • IPAddress
    Adresse IP de l'application.

  • Port
    Port SSL associé à la liaison.

  • Lcid
    Paramètres régionaux à utiliser pour les messages d'erreur retournés.

  • Error
    [out] Description des erreurs qui se sont produites.

  • HRESULT
    [out] Valeur indiquant si l'appel a réussi ou échoué.

Valeur de retour

Retourne un paramètre HRESULT qui indique si l'appel de la méthode a abouti ou a échoué. La valeur 0 indique que l'appel de la méthode a abouti ; un code d'erreur indique que l'appel n'a pas abouti.

Notes

Cette méthode ajoute une liaison à rsreportserver.config pour l'application. Si aucune liaison n'existe déjà dans HTTP.SYS, elle est créée ici.

Avant de créer la liaison, l'appel de méthode examine les réservations d'URL pour l'application spécifiée afin de déterminer si la liaison de certificat SSL est valide.

Les conditions suivantes sont validées et peuvent provoquer des erreurs :

  1. Le certificat n'existe pas.

  2. L'adresse IP spécifiée ne correspond à aucune adresse IP de cet ordinateur.

  3. L'adresse IP spécifiée est une adresse IP DHCP (modifications régulières) ; utilisez plutôt l'adresse IP générique (0.0.0.0).

  4. L'adresse IP spécifiée ne correspond pas à l'adresse IP des réservations d'URL ET il n'existe pas de réservation d'URL générique ni de nom d'hôte.

  5. Une réservation d'URL qui spécifie un nom d'hôte existe, mais le nom d'hôte ne correspond pas au nom d'hôte de certificat.

Conditions requises

Espace de noms : root\Microsoft\SqlServer\ReportServer\RS_<EncodedInstanceName>\v10\Admin

Plateforme : Windows Server 2003, Datacenter Edition ; Windows Server 2003, Enterprise Edition ; Windows Server 2003, Standard Edition ; Windows Vista ; Windows XP Professionnel avec Service Pack 2 (SP2) ou Service Pack 1 (SP1) ; ou Windows 2000 (toutes versions)