Stops a named service.

Syntax

bSuccess = IShellDispatch2.ServiceStop(sServiceName, vPersistent)

Parameters

sServiceName	Required. A String that contains the name of the service.
vPersistent	Required. A Variant that is set to true to have the service started by the service control manager when ServiceStart is called. To leave the service configuration unchanged, set vPersistent to false.

Return Value

Variant. Returns true if successful, or false otherwise.

Remarks

The method returns false if the service has already been stopped. Before calling this method, you can call IsServiceRunning to ascertain the status of the service.

This method is not currently available in Microsoft Visual Basic.

Examples

The following example uses ServiceStop to stop the Messenger service. Proper usage is shown for Microsoft JScript and Visual Basic Scripting Edition (VBScript).

JScript:

<script language="JScript">
    function fnServiceStopJ()
    {
        var objShell = new ActiveXObject("Shell.Application");
        var bReturn;
        
        bReturn = objShell.ServiceStop("Messenger", true);
    }
</script>

VBScript:

<script language="VBScript">
    function fnServiceStopVB()
        dim objShell
        dim bReturn

        set objShell = CreateObject("Shell.Application")

        bReturn = objShell.ServiceStop("Messenger", true)

        set objShell = nothing
    end function
</script>

Applies To

IShellDispatch2