This topic has not yet been rated - Rate this topic

SetWindowsServiceIdentity Method (WMI MSReportServer_ConfigurationSetting Class)

SQL Server 2005

Makes the Report Server Windows service run as a specified Windows user, and grants this account sufficient file system permissions to allow the report server to operate.

Syntax

Public Sub SetWindowsServiceIdentity(UseBuiltInAccount as Boolean,_
    Account as String, Password as String, ByRef HRESULT as Int32)

public void SetWindowsServiceIdentity(boolean UseBuiltInAccount, 
    string Account, string Password, out sint32 HRESULT);

Parameters

UseBuiltInAccount: Indicates whether the specified account is a built-in Windows account.

Account: The Windows account to use to run the Windows service, in the format "DOMAIN\alias".

Password: The password for the account.

HRESULT: [out] Value indicating whether the call succeeded or failed.

Return Value

Returns an HRESULT indicating success or failure of the method call. A value of 0 indicates that the method call was successful. A non-zero value indicates that an error has occurred.

Remarks

When the UseBuiltInAccount parameter is set to true and the report server is running on Windows 2000 or Windows XP, the value of the Name, Domain, and Password parameters are ignored and the Local system account is used.

When the UseBuiltInAccount parameter is set to true and the report server is running on Windows 2003, the Domain and Password properties are ignored, and the name field must contain either “Builtin\NetworkService” or “Builtin\System” or “Builtin\LocalService”.

The SetWindowsServiceIdentity method sets file permissions on files and folders in the report server installation directory.

The account specified in the Account parameter requires LogonAsService permission in Windows. The method grants this permission to the specified account.

Requirements

Namespace: root\Microsoft\SqlServer\ReportServer\v9\Admin

Platform: Windows Server 2003, Datacenter Edition; Windows Server 2003, Enterprise Edition; Windows Server 2003, Standard Edition; Windows Vista; Windows XP Professional with Service Pack 2 (SP2) or Service Pack 1 (SP1); or Windows 2000 (all versions)

Reference

MSReportServer_ConfigurationSetting Members
MSReportServer_ConfigurationSettingForSharePoint Members

Help and Information

Getting SQL Server 2005 Assistance

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Additions

ADD