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