Méthode Shell.ServiceStart

Article
06/13/2023

Démarre un service nommé.

Syntaxe

retVal = Shell.ServiceStart(
  sServiceName,
  vPersistent
)


Shell.ServiceStart( _
  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é automatiquement par le gestionnaire de contrôle de service au démarrage du système. Définissez sur false pour laisser la configuration du service inchangée.

Valeur retournée

JScript

Type : Variant*

Retourne la valeur true si elle réussit ; sinon, false.

VB

Type : Variant*

Retourne la valeur true si elle réussit ; sinon, false.

Notes

La méthode retourne false si le service a déjà été démarré. 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 ServiceStart pour démarrer le service Messenger. L’utilisation est indiquée pour JScript et VBScript.

Jscript:

<script language="JScript">
    function fnServiceStartJ()
    {
        var objShell = new ActiveXObject("shell.application");
        var bReturn;
        
        bReturn = objShell.ServiceStart("Messenger", true);
    }

Vbscript:

<script language="VBScript">
    function fnServiceStartVB()
        dim objShell
        dim bReturn

        set objShell = CreateObject("shell.application")

        bReturn = objShell.ServiceStart("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)

Partager via