Partager via


Méthode SetDatabaseConnection (WMI MSReportServer_ConfigurationSetting)

Définit la connexion à une base de données de serveur de rapports spécifique.

Syntaxe

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

Paramètres

  • Server
    Nom de l'instance SQL Server utilisée pour héberger la base de données du serveur de rapports.

  • DatabaseName
    Nom de la base de données du serveur de rapports.

  • CredentialsType
    Type d'informations d'identification à utiliser pour la connexion. Les valeurs peuvent être les suivantes :

    • 0 - Windows

    • 1 – SQL Server 

    • 2 - Service Windows

  • UserName
    Nom du compte utilisé pour établir la connexion à la base de données du serveur de rapports.

  • Password
    Mot de passe utilisé pour établir la connexion à la base de données du serveur de rapports.

  • HRESULT
    [out] Valeur indiquant si l'appel a réussi ou a échoué.

Valeur de retour

Retourne un paramètre HRESULT qui indique si l'appel de la méthode a réussi ou a échoué. La valeur 0 indique que l'appel de la méthode a réussi. Une valeur différente de zéro indique qu'une erreur s'est produite.

Notes

Lorsque le paramètre CredentialsType a la valeur 0 (Windows), les paramètres UserName et Password doivent être définis. Le paramètre UserName doit être au format « domaine\nom d'utilisateur », et la valeur doit représenter une ouverture de session Windows valide.

Lorsque le paramètre CredentialsType a la valeur 1 (SQL Server), la valeur transmise dans le paramètre UserName doit être conforme aux spécifications d'un nom de connexion SQL Server.

Lorsque le paramètre CredentialsType a la valeur 2 (Service Windows), le serveur de rapports utilise la sécurité intégrée pour se connecter à la base de données, et les paramètres UserName et Password sont ignorés. Le service Web Report Server utilise soit le compte ASP.NET, soit le compte d'un pool d'applications et le compte de service Windows pour accéder à la base de données du serveur de rapports.

Lorsque la méthode SetDatabaseConnection est appelée, elle chiffre et stocke les informations d'identification et les informations sur la base de données dans le fichier de configuration du serveur de rapports spécifié.

La méthode SetDatabaseConnection ne vérifie pas si le serveur de rapports peut se connecter à la base de données à l'aide des données spécifiées.

Lorsqu'elle est configurée pour la première fois, la propriété ConnectionPoolSize est définie selon les processeurs suivants : ConnectionPoolSize = #Processors * 75.

La méthode SetDatabaseConnection n'accorde pas d'autorisations aux comptes spécifiés. Vous devez appeler la méthode GenerateDatabaseRightsScript pour chaque compte qui doit accéder à la base de données du serveur de rapports et exécuter le script obtenu.

Spécifications

Espace de noms : root\Microsoft\SqlServer\ReportServer\<NomInstance>\v11\Admin

Plateforme : Windows Server 2003, Datacenter Edition ; Windows Server 2003, Enterprise Edition ; Windows Server 2003, Standard Edition ; Windows Vista ; Windows XP Professionnel avec Service Pack 2 (SP2) ou Service Pack 1 (SP1) ; ou Windows 2000 (toutes versions)

Voir aussi

Référence

Membres MSReportServer_ConfigurationSetting