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

Article
03/04/2024

Configure une application COM+ pour qu’elle s’exécute en tant que service Windows.

Syntaxe

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

Paramètres

[in] bstrApplicationIDOrName

ID d’application ou nom de l’application.

[in] bstrServiceName

Nom du service de l’application. Ce nom est le nom interne utilisé par le gestionnaire de contrôle de service (SCM), et non le nom d’affichage.

[in] bstrStartType

Quand démarrer le service. Les arguments valides sont les options du paramètre dwStartType de la fonction CreateService . Les arguments doivent être entre guillemets. Voici les arguments valides : SERVICE_BOOT_START, SERVICE_SYSTEM_START, SERVICE_AUTO_START, SERVICE_DEMAND_START et SERVICE_DISABLED.

[in] bstrErrorControl

Gravité de l’erreur si ce service ne parvient pas à démarrer au démarrage. L’erreur détermine l’action effectuée par le programme de démarrage en cas d’échec. Les arguments valides sont les options du paramètre dwErrorControl de la fonction CreateService . Les arguments doivent être entre guillemets. Voici les arguments valides : SERVICE_ERROR_IGNORE, SERVICE_ERROR_NORMAL, SERVICE_ERROR_SEVERE et SERVICE_ERROR_CRITICAL.

[in] bstrDependencies

Liste des dépendances pour le service. Il existe deux formats possibles pour la chaîne : une chaîne standard délimitée par des valeurs Null et terminée à double null (exactement comme documenté pour CreateService) ; ou une liste de noms de service compatibles avec les scripts séparés par « » (caractère non valide à avoir dans un nom de service). Le service rpcss est implicite dans ce paramètre et n’a pas besoin d’être spécifié.

[in] bstrRunAs

Nom d’utilisateur sous lequel exécuter ce service. Si ce paramètre a la valeur NULL, le service s’exécute en tant que service local.

[in] bstrPassword

Mot de passe du compte d’utilisateur système. Ce paramètre doit avoir la valeur NULL si le service est configuré pour s’exécuter en tant que service local.

[in] bDesktopOk

Indique si le service doit être autorisé à interagir avec le bureau. Ce paramètre est valide uniquement lorsque le service est marqué comme service local et doit être FALSE dans le cas contraire.

Valeur retournée

Cette méthode peut retourner les valeurs de retour standard E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL et S_OK.

Remarques

Un service créé par cette méthode peut être supprimé à l’aide de la méthode DeleteServiceForApplication .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	comadmin.h

Voir aussi

ICOMAdminCatalog2

Share via