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