• Artikel

SetSecureConnectionLevel-Methode (WMI: MSReportServer_ConfigurationSetting)

Legt die sichere Verbindungsebene des Berichtsservers fest

Syntax

Public Sub SetSecureConnectionLevel(Level as Integer, _
    ByRef HRESULT as Int32)

public void SetSecureConnectionLevel(Int32 Level, 
    out Int32 HRESULT);

Parameter

  • Level
    Ein ganzzahliger Wert, der eine sichere Verbindungsebene darstellt

  • 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 Wert ungleich 0 (null) gibt an, dass ein Fehler aufgetreten ist.

Hinweise

Bei einem Aufruf wird die SecureConnectionLevel-Eigenschaft des Berichtsservers auf den angegebenen Wert festgelegt. Der Wert 0 gibt an, dass SSL deaktiviert wird. Ein Wert größer oder gleich 1 gibt an, dass SSL aktiviert wird.

  • Wenn der Wert festgelegt ist, wird das SecureConnectionLevel-Element in der Berichtsserver-Konfigurationsdatei geändert, und für das URLRoot-Element in der Konfigurationsdatei wird die Verwendung von "https://" festgelegt, wenn das angegebene Level größer oder gleich 1 ist. Wenn das angegebene Level 0 ist, wird die Verwendung von "http://" festgelegt.

In SQL Server 2008 R2 wird SecureConnectionLevel zu einer ON-/OFF-Option mit dem Standardwert 0. Bei einem beliebigen Wert größer oder gleich 1, der über eine API der SetSecureConnectionLevel-Methode übergeben wird, wird SSL als ON angesehen und die SecureConnectionLevel-Konfigurationseigenschaft in der Datei rsreportserver.config entsprechend festgelegt. Werte von 2 und 3 werden weiterhin aus Gründen der Abwärtskompatibilität zugelassen.

Voraussetzungen

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)