ManageServer Method

Starts, stops, or restarts a server.

Syntax

Function ManageServer(
    Operation As CeServerManageOp,
    [TimeoutSeconds As Long = 20],
    [UserName As String],
    [Password As String]) As Boolean

Parameters

Operation

The type of operation to perform on the server. This includes starting, stopping, and restarting.

TimeoutSeconds

The amount of time, in seconds, before the attempt to change the state of the service will fail. This value is set by default to 20 seconds.

UserName

The operating system user name.

Password

The operating system password.

Remarks

Optional parameters include operating system user name and password to authenticate with a remote server, as well as a time-out for setting the length of time before the attempt to change the state of the service will fail. This method returns True if service is already on the requested state. See Starting, restarting, and stopping a server for more information.

Note:    When stopping, starting, and restarting a server in Unix, or when authenticating a remote server in Windows, you must supply the TimeoutSeconds, UserName and Password parameters. For Windows, the UserName parameter should contain the format Domain\UserName.

Tip:    When you stop (or restart) a server, you terminate the server's Process ID, thereby stopping the server completely. If you want to prevent a server from receiving requests without actually stopping the server process, you can also enable and disable servers. For details, see the Disabled Property.

The SI_NTSERVICE_NAME Property, SI_NAME Property, and SI_SERVER_NAME Property must be retrieved in order to use this method.