ConfigurationSetting Method – CreateSSLCertificateBinding (ConfigurationSetting-Methode: CreateSSLCertificateBinding)

Erstellt eine TLS/SSL-Zertifikatsbindung.

Syntax

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

Parameter

Anwendung
Der Name der Anwendung, für die die Zertifikatsbindung erstellt werden soll

CertificateHash
Der Hash für das Zertifikat Für certificateHash wird ein Hash in Kleinbuchstaben erwartet. Wenn der Hash Großbuchstaben enthält, kommt es zu einem Fehler.

IPAddress
Die IP-Adresse für die Anwendung

Port
Der TLS-Port, der der Bindung zugeordnet ist.

Lcid
Das Gebietsschema, das für die zurückgegebenen Fehlermeldungen verwendet werden soll

Fehler
[out] Die Beschreibung der Fehler, die aufgetreten sind

HRESULT
[out] Wert, der angibt, ob der Aufruf erfolgreich war oder zu einem Fehler geführt hat.

Rückgabewert

Gibt HRESULT zurück, wodurch der Erfolg oder das Fehlschlagen des Methodenaufrufs angegeben wird. Der Wert 0 (null) gibt an, dass der Methodenaufruf erfolgreich war. Ein Fehlercode gibt an, dass der Aufruf nicht erfolgreich war.

Hinweise

Diese Methode fügt rsreportserver.config eine Bindung für die Anwendung hinzu. Wenn HTTP.SYS noch keine Bindung enthält, wird eine dort erstellt.

Vor dem Erstellen der Bindung untersucht der Methodenaufruf die URL-Reservierungen für die angegebene Anwendung, um zu überprüfen, ob die TLS/SSL-Zertifikatsbindung gültig ist.

Die folgenden Bedingungen werden überprüft und können Ursache für Fehler sein:

1. Das Zertifikat ist nicht vorhanden.

2. Die angegebene IPAddress entspricht keiner IPAddress dieses Computers.

3. Die angegebene IP-Adresse ist eine DHCP-IP-Adresse (ändert sich in regelmäßigen Abständen). Verwenden Sie stattdessen die Platzhalter-IP-Adresse (0.0.0.0).

4. Die angegebene IP-Adresse stimmt nicht mit der IP-Adresse einer URL-Reservierung überein UND es gibt weder einen Platzhalter noch eine URL-Reservierung mit einem Hostnamen.

5. Eine URL-Reservierung, die einen Hostnamen angibt, ist vorhanden, der Hostname stimmt jedoch nicht mit dem Zertifikathostnamen überein.

Anforderungen

Namespace:root\Microsoft\SqlServer\ReportServer\<InstanceName>\v13\Admin

Zugehöriger Inhalt

MSReportServer_ConfigurationSetting Mitglieder