通过

  • 项目

SetDatabaseConnection 方法 (WMI MSReportServer_ConfigurationSetting)

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

语法

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

参数

  • Server
    用于承载报表服务器数据库的 SQL Server 实例的名称。

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

  • CredentialsType
    用于连接的凭据类型。可为以下值：

    • 0 - Windows

    • 1 – SQL Server

    • 2 - Windows 服务

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

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

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

返回值

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

注释

如果将 CredentialsType 参数设置为 0 (Windows)，则必须设置参数 UserName 和 Password。UserName 参数的格式必须为“域\用户名”，相应的值必须代表有效的 Windows 登录名。

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

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

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

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

在第一次设置时，将根据以下处理器来设置 ConnectionPoolSize 属性：ConnectionPoolSize = 处理器数 * 75。

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

要求

命名空间： root\Microsoft\SqlServer\ReportServer\RS_<EncodedInstanceName>\v10\Admin

平台： Windows Server 2003 Datacenter Edition；Windows Server 2003 Enterprise Edition；Windows Server 2003 Standard Edition；Windows Vista；Windows XP Professional Service Pack 2 (SP2) 或 Service Pack 1 (SP1) 或者 Windows 2000（所有版本）