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


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

Требования

Пространство имен: корень\Microsoft\SqlServer\ReportServer\<имя_экземпляра>\v11\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 (все версии)

См. также

Справочник

Элементы MSReportServer_ConfigurationSetting