Fonction ResUtilStartResourceService (resapi.h)

Article
03/01/2024

Démarre un service. Le type PRESUTIL_START_RESOURCE_SERVICE définit un pointeur vers cette fonction.

Syntaxe

DWORD ResUtilStartResourceService(
  [in]  LPCWSTR     pszServiceName,
  [out] LPSC_HANDLE phServiceHandle
);

Paramètres

[in] pszServiceName

Chaîne Unicode terminée par null contenant le nom du service à démarrer.

[out] phServiceHandle

Pointeur facultatif vers un handle dans lequel le handle du service démarré est retourné. Ce handle doit être fermé par un appel à la fonction d’utilitaire de cluster ResUtilStopService ou à la fonction CloseServiceHandle.

Valeur retournée

Si l’opération réussit, la fonction retourne ERROR_SUCCESS.

Si l’opération échoue, la fonction retourne un code d’erreur système. Voici un code d’erreur possible.

Code de retour	Description
ERROR_SERVICE_NEVER_STARTED	Le service n’a pas démarré.

Remarques

La fonction de l’utilitaire ResUtilStartResourceService encapsule les appels nécessaires au gestionnaire de contrôle de service, ce qui offre un moyen pratique de démarrer des services dans le cluster. L’utilisation de ResUtilStartResourceService est facultative. Si le service à démarrer nécessite des restrictions d’accès spécifiques ou une autre gestion spéciale, utilisez plutôt les fonctions du gestionnaire de contrôle de service.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2008 Entreprise, Windows Server 2008 Datacenter
Plateforme cible	Windows
En-tête	resapi.h
Bibliothèque	ResUtils.lib
DLL	ResUtils.dll

Voir aussi

ResUtilStopService

Partager via