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