Fonction ResUtilSetResourceServiceStartParameters (resapi.h)

Ajuste les paramètres de début d’un service spécifié afin qu’il fonctionne correctement en tant que ressource de cluster. Il doit être appelé à partir d’une DLL de ressource. Le type PRESUTIL_SET_RESOURCE_SERVICE_START_PARAMETERS définit un pointeur vers cette fonction.

Syntaxe

DWORD ResUtilSetResourceServiceStartParameters(
  [in]      LPCWSTR            pszServiceName,
  [in]      SC_HANDLE          schSCMHandle,
  [in, out] LPSC_HANDLE        phService,
  [in]      PLOG_EVENT_ROUTINE pfnLogEvent,
  [in]      RESOURCE_HANDLE    hResourceHandle
);

Paramètres

[in] pszServiceName

Pointeur vers une chaîne Unicode terminée par null spécifiant le nom du service.

[in] schSCMHandle

Gérez le Gestionnaire de contrôle de service (SCM) ou NULL. Si la valeur est NULL, la fonction tente d’ouvrir un handle au SCM.

[in, out] phService

En entrée, un handle de service NULL . En sortie, gérez le service spécifié si l’appel a réussi, sinon NULL.

[in] pfnLogEvent

Pointeur vers la fonction de point d’entrée LogEvent de la DLL de ressource qui gère le service.

[in] hResourceHandle

Handle de ressource requis par la fonction de point d’entrée LogEvent . Utilisez le handle passé à la DLL dans la fonction Ouvrir le point d’entrée.

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.

Remarques

ResUtilSetResourceServiceStartParameters vérifie que le service n’est pas désactivé, modifie la configuration du service en mode démarrage manuel et empêche le service de redémarrer en réponse à une défaillance. Cela permet au cluster et à la DLL de ressource de contrôler le service.

Si votre DLL de ressource gère un service, utilisez ResUtilSetResourceServiceStartParameters et ResUtilSetResourceServiceEnvironment avant de mettre le service en ligne.

Configuration requise

Voir aussi

LogEvent

En ligne

Ouvrir

ResUtilSetResourceServiceEnvironment