Метод IShellDispatch2.ServiceStart

Запускает именованную службу.

Синтаксис

retVal = IShellDispatch2.ServiceStart(
  sServiceName,
  vPersistent
)

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

Параметры

sServiceName [in]

Тип: BSTR

Строка, содержащая имя службы.

vPersistent [in]

Тип: Variant

Задайте значение true , чтобы служба автоматически запускалась диспетчером управления службами во время запуска системы. Задайте значение false , чтобы оставить конфигурацию службы без изменений.

Возвращаемое значение

Язык JScript

Тип: Variant*

Возвращает значение true при успешном выполнении; в противном случае — false.

VB

Тип: Variant*

Возвращает значение true при успешном выполнении; в противном случае — false.

Комментарии

Этот метод реализован и доступен с помощью метода Shell.ServiceStart .

Метод возвращает значение false , если служба уже запущена. Перед вызовом этого метода можно вызвать Shell.IsServiceRunning , чтобы определить состояние службы.

В настоящее время этот метод недоступен в Microsoft Visual Basic.

Примеры

В следующих примерах показано использование ServiceStart для запуска службы Messenger. Использование отображается для JScript и VBScript.

Jscript:

<script language="JScript">
    function fnServiceStartJ()
    {
        var objShell = new ActiveXObject("shell.application");
        var bReturn;
        
        bReturn = objShell.ServiceStart("Messenger", true);
    }
</script>

Vbscript:

<script language="VBScript">
    function fnServiceStartVB()
        dim objShell
        dim bReturn

        set objShell = CreateObject("shell.application")

        bReturn = objShell.ServiceStart("Messenger", true)

        set objShell = nothing
    end function
</script>

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Заголовок	Shldisp.h
IDL	Shldisp.idl
DLL	Shell32.dll (версия 5.0 или более поздняя)