Shell.ServiceStart-Methode

Startet einen benannten Dienst.

Syntax

retVal = Shell.ServiceStart(
  sServiceName,
  vPersistent
)

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

Parameter

sServiceName [in]

Typ: BSTR

Eine Zeichenfolge , die den Namen des Diensts enthält.

vPersistent [in]

Typ: Variant

Legen Sie auf true fest, damit der Dienst während des Systemstarts automatisch vom Dienststeuerungs-Manager gestartet wird. Legen Sie auf false fest, um die Dienstkonfiguration unverändert zu lassen.

Rückgabewert

JScript

Typ: Variant*

Gibt true zurück, wenn dies erfolgreich war. andernfalls false.

VB

Typ: Variant*

Gibt true zurück, wenn dies erfolgreich war. andernfalls false.

Bemerkungen

Die Methode gibt false zurück, wenn der Dienst bereits gestartet wurde. Bevor Sie diese Methode aufrufen, können Sie Shell.IsServiceRunning aufrufen, um die status des Diensts zu ermitteln.

Diese Methode ist derzeit nicht in Microsoft Visual Basic verfügbar.

Beispiele

Die folgenden Beispiele zeigen die Verwendung von ServiceStart zum Starten des Messenger-Diensts. Die Verwendung wird für JScript und VBScript angezeigt.

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>

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Shldisp.h
IDL	Shldisp.idl
DLL	Shell32.dll (Version 5.0 oder höher)