Método Shell.ServiceStart

Inicia um serviço nomeado.

Sintaxe

retVal = Shell.ServiceStart(
  sServiceName,
  vPersistent
)

Shell.ServiceStart( _
  ByVal sServiceName As BSTR, _
  ByVal vPersistent As Variant _
) As Variant

Parâmetros

sServiceName [in]

Tipo: BSTR

Uma Cadeia de Caracteres que contém o nome do serviço.

vPersistent [in]

Tipo: Variant

Defina como true para que o serviço seja iniciado automaticamente pelo gerenciador de controle de serviço durante a inicialização do sistema. Defina como false para deixar a configuração do serviço inalterada.

Valor retornado

JScript

Tipo: Variant*

Retorna true se tiver êxito; caso contrário, false.

VB

Tipo: Variant*

Retorna true se tiver êxito; caso contrário, false.

Comentários

O método retornará false se o serviço já tiver sido iniciado. Antes de chamar esse método, você pode chamar Shell.IsServiceRunning para verificar a status do serviço.

Esse método não está disponível no momento no Microsoft Visual Basic.

Exemplos

Os exemplos a seguir mostram o uso do ServiceStart para iniciar o serviço messenger. O uso é mostrado para JScript e VBScript.

Jscript:

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

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	Valor
Cliente mínimo com suporte	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	Shldisp.h
IDL	Shldisp.idl
DLL	Shell32.dll (versão 5.0 ou posterior)