Shell.ServiceStop メソッド

名前付きサービスを停止します。

構文

retVal = Shell.ServiceStop(
  sServiceName,
  vPersistent
)

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

パラメーター

sServiceName [in]

種類: BSTR

サービスの名前を含む 文字列 。

vPersistent [in]

型: Variant

ServiceStart が呼び出されたときにサービス コントロール マネージャーによってサービスが開始される場合は、true に設定します。 サービス構成を変更しない場合は、 vPersistent を false に設定 します。

戻り値

JScript

型: Variant*

成功した場合は true を 返します。それ以外の場合は false。

VB

型: Variant*

成功した場合は true を 返します。それ以外の場合は false。

解説

サービスが既に停止している場合、メソッドは 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 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップ アプリのみ]
Header	Shldisp.h
IDL	Shldisp.idl
[DLL]	Shell32.dll (バージョン 5.0 以降)