Поделиться через


Метод 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 пропускаются. Веб-служба сервера отчетов использует для доступа к базе данных сервера отчетов либо учетную запись ASP.NET, либо учетную запись пула приложений и учетную запись службы Windows.

При вызове метода SetDatabaseConnection учетные данные и сведения о базе данных зашифровываются и сохраняются в файле конфигурации для указанного сервера отчетов.

Метод SetDatabaseConnection не проверяет, может ли сервер отчетов соединиться с базой данных сервера отчетов с помощью указанных данных.

При первой установке свойство ConnectionPoolSize имеет значение на основе следующего количества процессоров: ConnectionPoolSize = число процессоров * 75.

Метод SetDatabaseConnection не предоставляет разрешения указанным учетным записям. Следует вызвать метод GenerateDatabaseRightsScript для каждой учетной записи, которой требуется доступ к базе данных сервера отчетов, и запустить получившийся сценарий.

Системные требования

Пространство имен: root\Microsoft\SqlServer\ReportServer\RS_<закодированное_имя_экземпляра>\v10\Admin

Платформа: Windows Server 2003 Datacenter Edition; Windows Server 2003 Enterprise Edition; Windows Server 2003 Standard Edition; Windows Vista; Windows XP Professional с пакетом обновления 2 (SP2) или 1 (SP1) или Windows 2000 (все версии).

См. также

Справочник