SetServiceAccount Method (SqlService Class)

Syntax

object.SetServiceAccount(ServiceStartName , ServiceStartPassword)

Parts

• object
  A SqlService Class object that represents the service.

Parameters

• ServiceStartName
  A string value that specifies the account name that the service runs under. Depending on the service type, the account name might be in the form of DomainName\Username. When it runs, the service process will be logged using one of two forms:

  • If the account belongs to the built-in domain, \Username can be specified.

  • If NULL is specified, the service will be logged on as the LocalSystem account.

  For kernel or system-level drivers, StartName contains the driver object name, either \FileSystem\Rdr or \Driver\Xns, which the I/O system uses to load the device driver. If NULL is specified, the driver runs with a default object name created by the I/O system based on the service name, for example, DWDOM\Admin.

• ServiceStartPassword
  A string value that specifies the password for the account name in the StartName parameter. Specify NULL if you are not changing the password. Specify an empty string if the service has no password.

Property Value/Return Value

A uint32 value, which is 0 if the service was successfully modified or 1 if the request is not supported. Any other number indicates an error.

See Also

Concepts