Метод ICOMAdminCatalog2::CreateServiceForApplication (comadmin.h)

Статья
08/22/2023

Настраивает приложение COM+ для запуска в качестве службы Windows.

Синтаксис

HRESULT CreateServiceForApplication(
  [in] BSTR         bstrApplicationIDOrName,
  [in] BSTR         bstrServiceName,
  [in] BSTR         bstrStartType,
  [in] BSTR         bstrErrorControl,
  [in] BSTR         bstrDependencies,
  [in] BSTR         bstrRunAs,
  [in] BSTR         bstrPassword,
  [in] VARIANT_BOOL bDesktopOk
);

Параметры

[in] bstrApplicationIDOrName

Идентификатор или имя приложения.

[in] bstrServiceName

Имя службы приложения. Это внутреннее имя, используемое диспетчером управления службами (SCM), а не отображаемое имя.

[in] bstrStartType

Когда следует запускать службу. Допустимыми аргументами являются параметры параметра dwStartType функции CreateService . Аргументы должны быть заключены в кавычки. Ниже приведены допустимые аргументы: SERVICE_BOOT_START, SERVICE_SYSTEM_START, SERVICE_AUTO_START, SERVICE_DEMAND_START и SERVICE_DISABLED.

[in] bstrErrorControl

Серьезность ошибки, если эта служба не запускается во время запуска. Ошибка определяет действие, выполняемое программой запуска в случае сбоя. Допустимыми аргументами являются параметры параметра dwErrorControl функции CreateService . Аргументы должны быть заключены в кавычки. Ниже приведены допустимые аргументы: SERVICE_ERROR_IGNORE, SERVICE_ERROR_NORMAL, SERVICE_ERROR_SEVERE и SERVICE_ERROR_CRITICAL.

[in] bstrDependencies

Список зависимостей для службы. Существует два возможных формата для строки: стандартная строка с разделителями NULL, строка с двойным завершением null (точно так же, как описано для CreateService); или понятный для скрипта список имен служб, разделенных символом "" (недопустимый символ в имени службы). Служба rpcss неявна в этом параметре и не требуется указывать.

[in] bstrRunAs

Имя пользователя для запуска этой службы. Если этот параметр имеет значение NULL, служба будет работать как локальная служба.

[in] bstrPassword

Пароль для учетной записи системного пользователя. Этот параметр должен иметь значение NULL , если служба настроена для запуска как локальная служба.

[in] bDesktopOk

Указывает, следует ли разрешить службе взаимодействовать с рабочим столом. Этот параметр действителен, только если служба помечена как локальная служба и в противном случае должна иметь значение FALSE .

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

Этот метод может возвращать стандартные возвращаемые значения E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL и S_OK.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	comadmin.h

См. также раздел

ICOMAdminCatalog2

Поделиться через