Método SetDatabaseConnection (WMI MSReportServer_ConfigurationSetting)

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

• Server
  O nome da instância do SQL Server usado 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.

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

• HRESULT
  [fora] Valor que indica se a chamada teve sucesso ou falhou.

Valor de retorno

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 deverão 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 for definido como 1 (SQL Server), o valor transmitido no parâmetro UserName deverá estar em conformidade com os requisitos de um nome de login do SQL Server.

Quando o parâmetro CredentialsType é definido como 2 (Serviço do 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 do servidor de relatório usará a conta ASP.NET ou uma conta do pool de aplicativos e a conta do serviço do 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 = #Processors * 75.

O método SetDatabaseConnection não concede permissões para a(s) conta(s) especificada(s). 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: raiz\Microsoft\SqlServer\ReportServer\RS_<Nome_da_Instância_Codificado>\v10\Admin

**Plataforma:**Windows Server 2003, Datacenter Edition; Windows Server 2003, Enterprise Edition; Windows Server 2003, Standard Edition; Windows Vista; Windows XP Professional com Service Pack 2 (SP2) ou Service Pack 1 (SP1); ou Windows 2000 (todas as versões)

Consulte também

Referência