Partager via

Fonction ResUtilGetEnvironmentWithNetName (resapi.h)

  • Article

Ajuste les données d’environnement d’une ressource afin que la ressource utilise un nom de réseau de cluster pour identifier son emplacement. La ressource doit dépendre d’une ressource nom de réseau . Le type PRESUTIL_GET_ENVIRONMENT_WITH_NET_NAME définit un pointeur vers cette fonction.

Syntaxe

LPVOID ResUtilGetEnvironmentWithNetName(
  [in] HRESOURCE hResource
);

Paramètres

[in] hResource

Gérez une ressource qui dépend d’une ressource nom de réseau.

Valeur retournée

Si les opérations réussissent, la fonction retourne un pointeur vers le bloc d’environnement.

Si l’opération échoue, la fonction retourne NULL. Pour plus d’informations, appelez GetLastError.

Remarques

La fonction ResUtilGetEnvironmentWithNetName ajoute des variables d’environnement au bloc d’environnement actuel. Transmettez le bloc d’environnement retourné à CreateProcess lors du démarrage de la ressource pour obtenir les effets suivants :

  • Les clients et le cluster peuvent localiser la ressource à l’aide du nom de la ressource Nom du réseau.
  • Si la ressource appelle GetComputerName, GetComputerNameEx ou gethostbyname, le nom du réseau est retourné quel que soit le nœud qui héberge actuellement la ressource.
Si la ressource identifiée par hResource ne dépend pas d’une ressource nom de réseau, ResUtilGetEnvironmentWithNetName retourne NULL.

Utilisez ResUtilFreeEnvironment pour détruire le bloc d’environnement.

N’appelez pas ResUtilGetEnvironmentWithNetName à partir d’une fonction de point d’entrée DLL de ressource. ResUtilGetEnvironmentWithNetName 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

ResUtilSetResourceServiceEnvironment