Shell. ServiceStop, méthode

Arrête un service nommé.

Syntaxe

retVal = Shell.ServiceStop(
  sServiceName,
  vPersistent
)

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

Paramètres

sServiceName [ dans]

Type : BSTR

Chaîne qui contient le nom du service.

vPersistent [ dans]

Type : variante

Affectez la valeur true pour que le service soit démarré par le gestionnaire de contrôle des services lors de l’appel de ServiceStart . Pour que la configuration du service reste inchangée, affectez à vPersistent la valeur false.

Valeur renvoyée

JScript

Type : variante *

Retourne la valeur true en cas de réussite ; Sinon, false.

VB

Type : variante *

Retourne la valeur true en cas de réussite ; Sinon, false.

Notes 

La méthode retourne la valeur false si le service a déjà été arrêté. Avant d’appeler cette méthode, vous pouvez appeler Shell. IsServiceRunning pour déterminer l’état du service.

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

Exemples

Les exemples suivants illustrent l’utilisation de ServiceStop pour arrêter le service Messenger. L’utilisation est indiquée pour JScript et VBScript.

Langage

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

Configuration requise

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