Méthode IShellDispatch2. IsServiceRunning

Retourne une valeur qui indique si un service particulier est en cours d’exécution.

Syntaxe

retVal = IShellDispatch2.IsServiceRunning(
  sServiceName
)

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

Paramètres

sServiceName [ dans]

Type : BSTR

Chaîne qui contient le nom du service.

Valeur de retour

JScript

Type : variante *

Retourne la valeur true si le service spécifié par sServiceName est en cours d’exécution ; Sinon, false.

VB

Type : variante *

Retourne la valeur true si le service spécifié par sServiceName est en cours d’exécution ; Sinon, false.

Remarques

Cette méthode est implémentée et accessible par le biais de la méthode Shell. IsServiceRunning .

Cette méthode n’est pas disponible actuellement dans Microsoft Visual Basic.

Exemples

Les exemples suivants illustrent l’utilisation de IsServiceRunning pour déterminer si le service themes est en cours d’exécution pour une application. l’utilisation est indiquée pour JScript et VBScript.

JScript :

<script language="JScript">
    function fnIsServiceRunningJ()
    {
        var objShell = new ActiveXObject("shell.application");
        var bReturn;
    
        bReturn = objShell.IsServiceRunning("Themes");
    }
</script>

VBScript

<script language="VBScript">
    function fnIsServiceRunningVB()
        dim objShell
        dim bReturn
    
        set objShell = CreateObject("shell.application")
    
        bReturn = objShell.IsServiceRunning("Themes")
    
        set objShell = nothing
    end function
</script>

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows 2000 Professional, Windows XP [ desktop apps uniquement]
Serveur minimal pris en charge
Windows Serveur 2003 [ applications de bureau uniquement]
En-tête
Shldisp. h
MIDL
Shldisp. idl
DLL
Shell32.dll (version 5,0 ou ultérieure)