Partager via

Méthode ConfigurationSetting - CreateSSLCertificateBinding

  • Article

Crée une liaison de certificat TLS/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. CertificateHash attend un hachage en minuscules. Si le hachage contient des caractères majuscules, il échoue.

IPAddress
Adresse IP de l'application.

Port
Port TLS 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 retournée

Retourne un paramètre HRESULT qui indique si l'appel de la méthode a réussi 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, une liaison 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 TLS/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.

Spécifications

Espace de noms : root\Microsoft\SqlServer\ReportServer\<InstanceName>\v13\Admin

Contenu connexe