IShellDispatch2.ServiceStart-Methode

Startet einen benannten Dienst.

Syntax

retVal = IShellDispatch2.ServiceStart(
  sServiceName,
  vPersistent
)

IShellDispatch2.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 diese Einstellung auf TRUE fest, damit der Dienst während des Systemstarts automatisch vom Dienststeuerungs-Manager gestartet wird. Legen Sie diese Einstellung auf FALSE fest, um die Dienstkonfiguration unverändert zu lassen.

Rückgabewert

JScript

Typ: * Variant

Gibt true zurück, wenn erfolgreich. andernfalls FALSE.

VB

Typ: * Variant

Gibt true zurück, wenn erfolgreich. andernfalls FALSE.

Bemerkungen

Diese Methode wird implementiert und über die Shell.ServiceStart-Methode aufgerufen.

Die Methode gibt FALSE zurück, wenn der Dienst bereits gestartet wurde. Vor dem Aufrufen dieser Methode können Sie Shell.IsServiceRunning aufrufen, um den Status des Diensts zu ermitteln.

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

Beispiele

In den folgenden Beispielen wird die Verwendung von ServiceStart zum Starten des Messenger-Diensts gezeigt. 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);
    }
</script>

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>

Requirements (Anforderungen)

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