SetDatabaseConnection-Methode (WMI: MSReportServer_ConfigurationSetting)

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 BackupEncryptionKey(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. Folgende Werte sind möglich:

  • 0 – Windows

  • 1 – SQL Server

  • 2 – Windows-Dienst

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

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

• 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

Wenn der CredentialsType-Parameter auf 0 (Windows) festgelegt ist, müssen der UserName-Parameter und der Password-Parameter 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 der UserName-Parameter sowie der Password-Parameter 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.

Bei der ersten Festlegung wird die ConnectionPoolSize-Eigenschaft basierend auf den folgenden Prozessoren festgelegt: ConnectionPoolSize = #Processors * 75.

Die SetDatabaseConnection-Methode gewährt keine Berechtigungen für die angegebenen Konten. 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.

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)

Siehe auch

Verweis