Método IShellDispatch2.ServiceStart

Inicia un servicio con nombre.

Sintaxis

retVal = IShellDispatch2.ServiceStart(
  sServiceName,
  vPersistent
)

IShellDispatch2.ServiceStart( _
  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

Establezca en true para que el administrador de control de servicios inicie automáticamente el servicio durante el inicio del sistema. Establézcalo en false para dejar la configuración del servicio sin cambios.

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.ServiceStart .

El método devuelve false si el servicio ya se ha iniciado. 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 ServiceStart para iniciar el servicio Messenger. Se muestra el uso de JScript y VBScript.

Jscript:

<script language="JScript">
    function fnServiceStartJ()
    {
        var objShell = new ActiveXObject("shell.application");
        var bReturn;
        
        bReturn = objShell.ServiceStart("Messenger", true);
    }
</script>

Vbscript:

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

        set objShell = CreateObject("shell.application")

        bReturn = objShell.ServiceStart("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)