Metodo IShellDispatch2.ServiceStop

Arresta un servizio denominato.

Sintassi

retVal = IShellDispatch2.ServiceStop(
  sServiceName,
  vPersistent
)

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

Parametri

sServiceName [in]

Tipo: BSTR

Valore String contenente il nome del servizio.

vPersistent [in]

Tipo: Variant

Impostare su true per fare in modo che il servizio venga avviato dal gestore di controllo del servizio quando viene chiamato ServiceStart . Per lasciare invariata la configurazione del servizio, impostare vPersistent su false.

Valore restituito

JScript

Tipo: Variant*

Restituisce true se l'operazione riesce; in caso contrario, false.

VB

Tipo: Variant*

Restituisce true se l'operazione riesce; in caso contrario, false.

Commenti

Questo metodo viene implementato e accessibile tramite il metodo Shell.ServiceStop .

Il metodo restituisce false se il servizio è già stato arrestato. Prima di chiamare questo metodo, è possibile chiamare Shell.IsServiceRunning per verificare lo stato del servizio.

Questo metodo non è attualmente disponibile in Microsoft Visual Basic.

Esempio

Gli esempi seguenti illustrano l'uso di ServiceStop per arrestare il servizio Messenger. L'utilizzo viene visualizzato per JScript e 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>

Requisiti

Requisito Valore
Client minimo supportato
Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato
Windows Server 2003 [solo app desktop]
Intestazione
Shldisp.h
IDL
Shldisp.idl
DLL
Shell32.dll (versione 5.0 o successiva)