Compartir a través de

Método ICOMAdminCatalog2::CreateServiceForApplication (comadmin.h)

  • Artículo

Configura una aplicación COM+ para que se ejecute como un servicio de Windows.

Sintaxis

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
);

Parámetros

[in] bstrApplicationIDOrName

Identificador o nombre de la aplicación.

[in] bstrServiceName

Nombre del servicio de la aplicación. Este nombre es el nombre interno que usa el administrador de control de servicios (SCM), no el nombre para mostrar.

[in] bstrStartType

Cuándo iniciar el servicio. Los argumentos válidos son las opciones del parámetro dwStartType de la función CreateService . Los argumentos deben estar entre comillas. Estos son los argumentos válidos: SERVICE_BOOT_START, SERVICE_SYSTEM_START, SERVICE_AUTO_START, SERVICE_DEMAND_START y SERVICE_DISABLED.

[in] bstrErrorControl

Gravedad del error si este servicio no se inicia durante el inicio. El error determina la acción realizada por el programa de inicio si se produce un error. Los argumentos válidos son las opciones del parámetro dwErrorControl de la función CreateService . Los argumentos deben estar entre comillas. Estos son los argumentos válidos: SERVICE_ERROR_IGNORE, SERVICE_ERROR_NORMAL, SERVICE_ERROR_SEVERE y SERVICE_ERROR_CRITICAL.

[in] bstrDependencies

Lista de dependencias para el servicio. Hay dos formatos posibles para la cadena: una cadena delimitada por valores NULL estándar y terminada en doble null (exactamente como se documenta para CreateService); o una lista que admite scripts de nombres de servicio separados por "" (un carácter no válido que debe tener en un nombre de servicio). El servicio rpcss está implícito en este parámetro y no es necesario especificarlo.

[in] bstrRunAs

Nombre de usuario para ejecutar este servicio como. Si este parámetro es NULL, el servicio se ejecutará como servicio local.

[in] bstrPassword

La contraseña de la cuenta de usuario del sistema. Este parámetro debe ser NULL si el servicio está configurado para ejecutarse como servicio local.

[in] bDesktopOk

Indica si se debe permitir que el servicio interactúe con el escritorio. Este parámetro solo es válido cuando el servicio está marcado como Servicio local y debe ser FALSE en caso contrario.

Valor devuelto

Este método puede devolver los valores devueltos estándar E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL y S_OK.

Comentarios

Se puede quitar un servicio creado por este método mediante el método DeleteServiceForApplication .

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado comadmin.h

Consulte también

ICOMAdminCatalog2