Método IShellDispatch2.ServiceStop

Detiene un servicio con nombre.

Sintaxis

retVal = IShellDispatch2.ServiceStop(
  sServiceName,
  vPersistent
)

IShellDispatch2.ServiceStop( _
  ByVal sServiceName As BSTR, _
  ByVal vPersistent As Variant _
) As Variant

Parámetros

sServiceName [in]

Tipo: BSTR

Cadena que contiene el nombre del servicio.

vPersistent [in]

Tipo: Variant

Establézcalo en true para que el administrador de control de servicios inicie el servicio cuando se llame a ServiceStart . Para dejar la configuración del servicio sin cambios, establezca vPersistent en false.

Valor devuelto

JScript

Tipo: Variant*

Devuelve true si se ejecuta correctamente; de lo contrario, false.

VB

Tipo: Variant*

Devuelve true si se ejecuta correctamente; de lo contrario, false.

Comentarios

Este método se implementa y se accede a él a través del método Shell.ServiceStop .

El método devuelve false si el servicio ya se ha detenido. Antes de llamar a este método, puede llamar a Shell.IsServiceRunning para determinar el estado del servicio.

Este método no está disponible actualmente en Microsoft Visual Basic.

Ejemplos

En los ejemplos siguientes se muestra el uso de ServiceStop para detener el servicio messenger. El uso se muestra para JScript y 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>

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	Shldisp.h
IDL	Shldisp.idl
Archivo DLL	Shell32.dll (versión 5.0 o posterior)