Freigeben über

  • Artikel

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 fehlgeschlagen ist

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 eine Bindung zu rsreportserver.config für die Anwendung hinzu. Wenn noch keine Bindung in HTTP.SYS vorhanden ist, wird sie erstellt.

Vor dem Erstellen der Bindung untersucht die Methode die URL-Reservierungen für die angegebene Anwendung, um zu ermitteln, ob die SSL-Zertifikatsbindung gültig ist.

Die folgenden Bedingungen werden überprüft und können zu einem Fehler führen:

  1. Zertifikat ist nicht vorhanden.

  2. Die angegebene IP-Adresse stimmt mit keiner der IP-Adressen des Computers überein.

  3. Die angegebene IP-Adresse ist eine DHCP-IP-Addresse (ändert sich regelmäßig). 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 ist weder eine Platzhalter- noch eine Hostnamen-URL-Reservierung vorhanden.

  5. Es ist eine URL-Reservierung vorhanden, die einen Hostnamen angibt, aber der Hostname stimmt nicht mit dem Hostnamen des Zertifikats überein.

Anforderungen

**Namespace:**root\Microsoft\SqlServer\ReportServer\RS_<EncodedInstanceName>\v10\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)