IShellDispatch2.ServiceStop-Methode
Beendet einen benannten Dienst.
Syntax
retVal = IShellDispatch2.ServiceStop(
sServiceName,
vPersistent
)
IShellDispatch2.ServiceStop( _
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 vom Dienststeuerungs-Manager gestartet wird, wenn ServiceStart aufgerufen wird. Um die Dienstkonfiguration unverändert zu lassen, legen Sie vPersistent auf false fest.
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.ServiceStop-Methode aufgerufen.
Die Methode gibt FALSE zurück, wenn der Dienst bereits beendet 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 ServiceStop zum Beenden des Messenger-Diensts gezeigt. Die Verwendung wird für JScript und VBScript angezeigt.
JScript:
<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>
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 |
|