Fonction ResUtilSetResourceServiceStartParametersEx (resapi.h)

Article
02/21/2025

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

Syntaxe

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

Paramètres

[in] pszServiceName

Pointeur vers une chaîne Unicode terminée par un caractère Null qui spécifie le nom du service.

[in] schSCMHandle

Handle pour le Gestionnaire de contrôle des services (SCM) ou NULL. Si la valeur est NULL, la fonction tente d’ouvrir un handle sur le SCM.

[in, out] phService

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

[in] dwDesiredAccess

Privilèges d’accès demandés. Il peut s’agir d’une combinaison de GENERIC_READ (0x80000000), de GENERIC_ALL (0x10000000) ou de MAXIMUM_ALLOWED (0x02000000). Si cette valeur est égale à zéro (0), une erreur non définie peut être retournée. L’utilisation de GENERIC_ALL revient à appeler ResUtilSetResourceServiceStartParameters.

[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 qui est 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

ResUtilSetResourceServiceStartParametersEx 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 à un échec. Cela permet au cluster et à la DLL de ressource de contrôler le service.

Si votre DLL de ressource gère un service, utilisez ResUtilSetResourceServiceStartParametersEx 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 2012
Plateforme cible	Windows
En-tête	resapi.h
Bibliothèque	ResUtils.lib
DLL	ResUtils.dll

Voir aussi

ResUtilSetResourceServiceStartParameters

Fonctions de l’utilitaire de service

Partager via