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 auf true fest, damit der Dienst vom Dienststeuerungs-Manager gestartet wird, wenn ServiceStart aufgerufen wird. Legen Sie vPersistent 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
Auf diese Methode wird über die Shell.ServiceStop-Methode zugegriffen.
Die Methode gibt false zurück, wenn der Dienst bereits beendet 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 ServiceStop zum Beenden des Messenger-Diensts. 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>
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 |
|
| IDL |
|
| DLL |
|