Compartilhar via

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

  • Artigo

Configura um aplicativo COM+ para ser executado como um serviço windows.

Sintaxe

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

A ID do aplicativo ou o nome do aplicativo.

[in] bstrServiceName

O nome do serviço do aplicativo. Esse nome é o nome interno usado pelo SCM (gerenciador de controle de serviço), não o nome de exibição.

[in] bstrStartType

Quando iniciar o serviço. Os argumentos válidos são as opções do parâmetro dwStartType da função CreateService . Os argumentos devem estar entre aspas. Veja a seguir os argumentos válidos: SERVICE_BOOT_START, SERVICE_SYSTEM_START, SERVICE_AUTO_START, SERVICE_DEMAND_START e SERVICE_DISABLED.

[in] bstrErrorControl

A gravidade do erro se esse serviço não for iniciado durante a inicialização. O erro determina a ação executada pelo programa de inicialização se ocorrer uma falha. Os argumentos válidos são as opções do parâmetro dwErrorControl da função CreateService . Os argumentos devem estar entre aspas. Veja a seguir os argumentos válidos: SERVICE_ERROR_IGNORE, SERVICE_ERROR_NORMAL, SERVICE_ERROR_SEVERE e SERVICE_ERROR_CRITICAL.

[in] bstrDependencies

Uma lista de dependências para o serviço. Há dois formatos possíveis para a cadeia de caracteres: uma cadeia de caracteres padrão delimitada por nulo, terminada em nulo duplo (exatamente como documentado para CreateService); ou uma lista amigável de script de nomes de serviço separados por "" (um caractere inválido para ter em um nome de serviço). O serviço rpcss está implícito nesse parâmetro e não precisa ser especificado.

[in] bstrRunAs

O nome de usuário para executar esse serviço como. Se esse parâmetro for NULL, o serviço será executado como Serviço Local.

[in] bstrPassword

A senha da conta de usuário do sistema. Esse parâmetro deverá ser NULL se o serviço estiver configurado para ser executado como Serviço Local.

[in] bDesktopOk

Indica se o serviço deve ter permissão para interagir com a área de trabalho. Esse parâmetro é válido somente quando o serviço é marcado como Serviço Local e deve ser FALSE caso contrário.

Retornar valor

Esse método pode retornar os valores de retorno padrão E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL e S_OK.

Comentários

Um serviço criado por esse método pode ser removido usando o método DeleteServiceForApplication .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho comadmin.h

Confira também

ICOMAdminCatalog2