ConfigurationSetting-Methode: SetDatabaseConnection

Legt die Berichtsserver-Datenbankverbindung auf eine bestimmte Berichtsserver-Datenbank fest

Syntax

Public Sub SetDatabaseConnection(Server as String, _  
    DatabaseName as string, CredentialsType as Integer, _  
    Username as String, Password as String, ByRef HRESULT as Int32)  

public void SetDatabaseConnection(string Server,   
    string DatabaseName, Int32 CredentialsType,   
    string UserName, string Password, out Int32 HRESULT);  

Parameter

Server
Der Name der SQL Server -Instanz, die zum Hosten der Berichtsserver-Datenbank verwendet wird.

DatabaseName
Der Name der Berichtsserver-Datenbank

CredentialsType
Der Typ der zu verwendenden Anmeldeinformationen für die Verbindung. Mögliche Werte:

• 0 – Windows

• 1 – SQL Server

• 2 – Windows-Dienst

UserName
Der Kontoname, der zum Herstellen der Verbindung mit der Berichtsserver-Datenbank verwendet wird

Kennwort
Das Kennwort, das zum Herstellen der Verbindung mit der Berichtsserver-Datenbank verwendet wird

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.

Hinweise

Wenn der CredentialsType -Parameter auf 0 (Windows) festgelegt ist, müssen die Parameter UserName und Password festgelegt werden. Der UserName -Parameter muss die Form domain\username haben, und der Wert muss einen gültigen Windows-Anmeldenamen darstellen.

Wenn der CredentialsType-Parameter auf 1 (SQL Server) festgelegt ist, muss der im UserName-Parameter übergebene Wert den Anforderungen an einen SQL Server-Anmeldenamen entsprechen.

Wenn der CredentialsType -Parameter auf 2 (Windows-Dienst) festgelegt ist, verwendet der Berichtsserver die integrierte Sicherheit, um eine Verbindung mit der Berichtsserver-Datenbank herzustellen, und die Parameter UserName und Password werden ignoriert. Der Report Server-Webdienst verwendet entweder das ASP.NET-Konto oder das Konto eines Anwendungspools und das Windows-Dienstkonto, um auf die Berichtsserver-Datenbank zuzugreifen.

Die SetDatabaseConnection-Methode verschlüsselt und speichert beim Aufruf die Anmelde- und Datenbankinformationen in der Konfigurationsdatei für den angegebenen Berichtsserver.

Die SetDatabaseConnection-Methode überprüft nicht, ob der Berichtsserver mithilfe der angegebenen Daten eine Verbindung mit der Berichtsserver-Datenbank herstellen kann.

Wenn die ConnectionPoolSize-Eigenschaft zum ersten Mal festgelegt wird, werden folgende Prozessoren zugrunde gelegt: ConnectionPoolSize = #Processors * 75

Die SetDatabaseConnection-Methode erteilt den angegebenen Konten keine Berechtigungen. Sie müssen die GenerateDatabaseRightsScript -Methode für jedes Konto aufrufen, das Zugriff auf die Berichtsserver-Datenbank erfordert, und dann das resultierende Skript ausführen.

Anforderungen

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

Zugehöriger Inhalt

MSReportServer_ConfigurationSetting Mitglieder