ConfigurationSetting 方法 - SetDatabaseConnection

设置与特定报表服务器数据库的报表服务器数据库连接。

语法

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);  

parameters

Server
用于托管报表服务器数据库的 SQL Server 实例名称。

DatabaseName
报表服务器数据库的名称。

CredentialsType
用于连接的凭据类型。 值可以是:

  • 0 - Windows

  • 1 - SQL Server

  • 2 - Windows 服务

UserName
连接报表服务器数据库时所用的帐户名。

密码
连接报表服务器数据库时所用的密码。

HRESULT
[out] 指示调用是成功还是失败的值。

返回值

返回 HRESULT ,指示方法调用是成功还是失败。 值 0 指示方法调用已成功。 非零值指示发生了错误。

注解

当 CredentialsType 参数设置为 0 (Windows) 时,必须设置 UserName 和 Password 参数。 UserName 参数的格式必须为 domain\username,相应的值必须代表有效的 Windows 登录名。

如果将 CredentialsType 参数设置为 1 (SQL Server),则 UserName 参数传递的值必须符合 SQL Server 登录名的要求。

如果将 CredentialsType 参数设置为 2(Windows 服务),则报表服务器将使用集成安全性连接到报表服务器数据库,并且忽略 UserName 和 Password 参数。 报表服务器 Web 服务使用 ASP.NET 帐户或应用程序池的帐户及 Windows 服务帐户访问报表服务器数据库。

调用后,SetDatabaseConnection 方法将加密凭证和数据库信息并将它们存储在指定报表服务器的配置文件中。

SetDatabaseConnection 方法不会检查报表服务器是否可以使用指定的数据连接到报表服务器数据库。

在第一次设置时,将根据以下处理器来设置 ConnectionPoolSize 属性:ConnectionPoolSize = #Processors * 75

SetDatabaseConnection 方法不会向指定的帐户授予权限。 您必须为需要访问报表服务器数据库的每一帐户调用 GenerateDatabaseRightsScript 方法,然后运行所生成的脚本。

要求

命名空间:root\Microsoft\SqlServer\ReportServer\<InstanceName>\v13\Admin