IShellDispatch2.ServiceStop 方法

停止具名服務。

語法

retVal = IShellDispatch2.ServiceStop(
  sServiceName,
  vPersistent
)

IShellDispatch2.ServiceStop( _
  ByVal sServiceName As BSTR, _
  ByVal vPersistent As Variant _
) As Variant

參數

sServiceName [in]

類型： BSTR

包含服務名稱的 String 。

vPersistent [in]

類型： Variant

當呼叫ServiceStart時，將 設定為true，讓服務控制管理員啟動服務。 若要讓服務組態保持不變，請將 vPersistent 設定為 false。

傳回值

JScript

類型： Variant*

如果成功，則傳回 true ;否則為 false。

VB

類型： Variant*

如果成功，則傳回 true ;否則為 false。

備註

此方法是透過 Shell.ServiceStop 方法實作和存取。

如果服務已經停止，此方法會傳回 false 。 呼叫此方法之前，您可以呼叫 Shell.IsServiceRunning 來確認服務的狀態。

這個方法目前無法在 Microsoft Visual Basic 中使用。

範例

下列範例示範如何使用 ServiceStop 來停止 Messenger 服務。 JScript 和 VBScript 會顯示使用量。

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>

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版、Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
標頭	Shldisp.h
Idl	Shldisp.idl
DLL	Shell32.dll (5.0 版或更新版本)