Fonction ResUtilSetResourceServiceEnvironment (resapi.h)

Article
03/01/2024

Ajuste les données d’environnement d’un service afin que le service utilise un nom de réseau de cluster pour identifier son emplacement. Cette fonction doit être appelée à partir d’une DLL de ressource. Le type PRESUTIL_SET_RESOURCE_SERVICE_ENVIRONMENT définit un pointeur vers cette fonction.

Syntaxe

DWORD ResUtilSetResourceServiceEnvironment(
  [in] LPCWSTR            pszServiceName,
  [in] HRESOURCE          hResource,
  [in] PLOG_EVENT_ROUTINE pfnLogEvent,
  [in] RESOURCE_HANDLE    hResourceHandle
);

Paramètres

[in] pszServiceName

Pointeur d’une chaîne Unicode terminée par un caractère Null contenant le nom du service.

[in] hResource

Handle de ressource pour le service obtenu à partir d’OpenClusterResource.

[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

ResUtilSetResourceServiceEnvironment appelle ResUtilGetEnvironmentWithNetName et stocke le bloc d’environnement résultant dans une entrée de Registre pour le service. Pour plus d’informations sur les effets du bloc d’environnement, consultez ResUtilGetEnvironmentWithNetName.

Si votre DLL de ressource gère un service, créez un thread de travail et utilisez ResUtilSetResourceServiceStartParameters et ResUtilSetResourceServiceEnvironment lors de la mise en ligne du service.

N’appelez pas ResUtilSetResourceServiceEnvironment à partir d’une fonction de point d’entrée DLL de ressource. ResUtilSetResourceServiceEnvironment peut être appelé en toute sécurité à partir d’un thread de travail. Pour plus d’informations, consultez Appels de fonction à éviter dans les DLL de ressources.

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

ResUtilGetEnvironmentWithNetName

Partager via