Fonction ResUtilGetEnvironmentWithNetName (resapi.h)
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.
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 |