Lire en anglais

Partager via


Méthode IShellDispatch2.ServiceStop

Arrête un service nommé.

Syntaxe

retVal = IShellDispatch2.ServiceStop(
  sServiceName,
  vPersistent
)

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

Paramètres

sServiceName [in]

Type : BSTR

Chaîne qui contient le nom du service.

vPersistent [in]

Type : Variant

Définissez sur true pour que le service soit démarré par le gestionnaire de contrôle de service lorsque ServiceStart est appelé. Pour laisser la configuration du service inchangée, définissez vPersistent surfalse.

Valeur retournée

JScript

Type : Variant*

Retourne true en cas de réussite ; sinon, false.

VB

Type : Variant*

Retourne true en cas de réussite ; sinon, false.

Notes

Cette méthode est implémentée et accessible via la méthode Shell.ServiceStop .

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

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

Exemples

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

Jscript:

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

Spécifications

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