CreateSSLCertificateBinding-Methode (WMI: MSReportServer_ConfigurationSetting)

Erstellt eine 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

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

• CertificateHash
  Der Hash für das Zertifikat

• IPAddress
  Die IP-Adresse für die Anwendung

• Port
  Der SSL-Port, der der Bindung zugeordnet ist.

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

• Error
  [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 diese dort erstellt.

Vor dem Erstellen der Bindung untersucht der Methodenaufruf die URL-Reservierungen für die angegebene Anwendung, um zu überprüfen, ob die 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 entspricht weder der IP-Adresse für URL-Reservierungen noch ist eine Platzhalter- oder Hostnamen-URL-Reservierung vorhanden.

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>\v11\Admin

Plattform: Windows Server 2003 Datacenter Edition; Windows Server 2003 Enterprise Edition; Windows Server 2003 Standard Edition; Windows Vista; Windows XP Professional mit Service Pack 2 (SP2) oder Service Pack 1 (SP1); oder Windows 2000 (alle Versionen)

Siehe auch

Verweis

MSReportServer_ConfigurationSetting-Member