Partilhar via


Método SetDatabaseConnection (WMI MSReportServer_ConfigurationSetting)

Define a conexão do banco de dados do servidor de relatório para um banco de dados do servidor de relatório específico.

Sintaxe

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

Parâmetros

Servidor
O nome da instância do SQL Server usada para hospedar o banco de dados do servidor de relatório.

DatabaseName
O nome do banco de dados do servidor de relatório.

CredentialsType
O tipo de credenciais a ser usada para a conexão. Os valores podem ser:

  • 0 - Windows

  • 1 - SQL Server

  • 2 - Serviço do Windows

UserName
O nome de conta usada para se conectar ao banco de dados do servidor de relatório.

Senha
A senha usada para se conectar ao banco de dados do servidor de relatório.

HRESULT
[out] Valor que indica se a chamada obteve êxito ou falhou.

Valor retornado

Retorna um HRESULT indicando êxito ou falha da chamada do método. Um valor 0 indica que a chamada do método teve êxito. Um valor diferente de zero indica que ocorreu um erro.

Comentários

Quando o parâmetro CredentialsType for definido como 0 (Windows), os parâmetros UserName e Password devem ser definidos. O parâmetro UserName deve estar no formulário "domain\username" e o valor deve representar um logon de Windows válido.

Quando o parâmetro CredentialsType é definido como 1 (SQL Server), o valor passado no parâmetro UserName deve estar em conformidade com os requisitos de um nome de logon do SQL Server.

Quando o parâmetro CredentialsType é definido como 2 (serviço Windows), o servidor de relatório usa a segurança integrada para se conectar ao banco de dados do servidor de relatório, e os parâmetros UserName e Password são ignorados. O serviço Web Servidor de Relatórios usará a conta ASP.NET ou uma conta do pool de aplicativos e a conta de serviço Windows para acessar o banco de dados do servidor de relatório.

Quando chamado, o método SetDatabaseConnection criptografa e armazena as credenciais e informações do banco de dados no arquivo de configuração para o servidor de relatório especificado.

O método SetDatabaseConnection não verifica se o servidor de relatório pode se conectar ao banco de dados do servidor de relatório usando os dados especificados.

Quando configurada pela primeira vez, a propriedade ConnectionPoolSize é definida com base nos seguintes processadores: ConnectionPoolSize = #Processadores * 75.

O método SetDatabaseConnection não concede permissões para as contas especificadas. Você deve chamar o método GenerateDatabaseRightsScript para cada conta que requer acesso ao banco de dados do servidor de relatório e executar o script resultante.

Requisitos

Namespace: root\Microsoft\SqlServer\ReportServer\<InstanceName>\v12\Admin

Confira também

Membros de MSReportServer_ConfigurationSetting