Método Shell.IsServiceRunning

Retorna um valor que indica se um determinado serviço está em execução.

Sintaxe

retVal = Shell.IsServiceRunning(
  sServiceName
)

Shell.IsServiceRunning( _
  ByVal sServiceName As BSTR _
) As Variant

Parâmetros

sServiceName [in]

Tipo: BSTR

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

Valor retornado

JScript

Tipo: Variant*

Retornará true se o serviço especificado por sServiceName estiver em execução; caso contrário, false.

VB

Tipo: Variant*

Retornará true se o serviço especificado por sServiceName estiver em execução; caso contrário, false.

Comentários

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

Exemplos

Os exemplos a seguir mostram o uso de IsServiceRunning para determinar se o serviço Temas está em execução para um aplicativo. O uso é mostrado para JScript e VBScript.

Jscript:

function fnIsServiceRunningJ()
{
    var objShell = new ActiveXObject("shell.application");
    var bReturn;

    bReturn = objShell.IsServiceRunning("Themes");
}

Vbscript:

function fnIsServiceRunningVB()
    dim objShell
    dim bReturn

    set objShell = CreateObject("shell.application")

    bReturn = objShell.IsServiceRunning("Themes")

    set objShell = nothing
end function

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)