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:
Das Zertifikat ist nicht vorhanden.
Die angegebene IPAddress entspricht keiner IPAddress dieses Computers.
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).
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.
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