ConfigurationSetting-Methode: SetSecureConnectionLevel

  • Artikel

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

Bemerkungen

Bei einem Aufruf wird die SecureConnectionLevel-Eigenschaft des Berichtsservers auf den angegebenen Wert festgelegt. Der Wert 0 gibt an, dass TLS deaktiviert wird. Ein Wert größer oder gleich 1 gibt an, dass TLS 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 (10.50.x) wird SecureConnectionLevel zu einer ON/OFF-Option, Standardwert ist 0 (null). Bei einem beliebigen Wert größer oder gleich 1, der über eine API der SetSecureConnectionLevel-Methode übergeben wird, wird TLS als aktiviert erachtet 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.

Requirements (Anforderungen)

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

Zugehöriger Inhalt

MSReportServer_ConfigurationSetting Mitglieder