Fonction ResUtilTerminateServiceProcessFromResDll (resapi.h)

Article
03/01/2024

Tente d’arrêter le processus d’un service géré en tant que ressource de cluster par une DLL de ressource. Le type PRESUTIL_TERMINATE_SERVICE_PROCESS_FROM_RES_DLL définit un pointeur vers cette fonction.

Syntaxe

DWORD ResUtilTerminateServiceProcessFromResDll(
  [in]            DWORD              dwServicePid,
  [in]            BOOL               bOffline,
  [out, optional] PDWORD             pdwResourceState,
  [in]            PLOG_EVENT_ROUTINE pfnLogEvent,
  [in]            RESOURCE_HANDLE    hResourceHandle
);

Paramètres

[in] dwServicePid

ID de processus du processus de service à arrêter.

[in] bOffline

Indique si la ressource est mise hors connexion ou est en cours d’arrêt. Spécifiez TRUE si vous appelez à partir du point d’entrée hors connexion ou à partir d’un thread de travail créé pour mettre la ressource hors connexion. Sinon, spécifiez FALSE et la fonction suppose que vous arrêtez la ressource.

[out, optional] pdwResourceState

Pointeur facultatif vers un DWORD qui retourne l’état résultant de la ressource, qui sera ClusterResourceFailed ou ClusterResourceOffline (pour obtenir la liste complète des états de ressource, consultez GetClusterResourceState). Passez la valeur NULL si vous n’avez pas besoin de ces informations.

[in] pfnLogEvent

Pointeur vers la fonction LogEvent utilisée par votre DLL de ressource. Ce pointeur est passé à votre DLL de ressource dans le point d’entrée de démarrage .

[in] hResourceHandle

Handle du Moniteur de ressources pour la ressource. Ce handle est passé à votre DLL de ressource dans le point d’entrée Open et doit être enregistré dans le cadre des données instance de la ressource.

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.

Notez que ResUtilTerminateServiceProcessFromResDll utilise pfnLogEvent et hResourceHandle pour écrire dans le journal des événements de votre DLL de ressource, ce qui peut aider à résoudre les défaillances.

Remarques

Vous devez uniquement appeler ResUtilTerminateServiceProcessFromResDll lors de la fin d’une ressource ou de la mise hors connexion d’une ressource.

Configuration requise

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

Voir aussi

Fonctions de l’utilitaire de service

Partager via