Fonction SetClusterName (clusapi.h)

Article
02/24/2024

Définit le nom d’un cluster. Le type PCLUSAPI_SetClusterName définit un pointeur vers cette fonction.

Syntaxe

DWORD SetClusterName(
  [in] HCLUSTER hCluster,
  [in] LPCWSTR  lpszNewClusterName
);

Paramètres

[in] hCluster

Gérez vers un cluster à renommer.

[in] lpszNewClusterName

Pointeur vers une chaîne Unicode terminée par null contenant le nouveau nom de cluster.

Valeur retournée

Si l’opération réussit, la fonction retourne ERROR_RESOURCE_PROPERTIES_STORED.

Si l’opération échoue, la fonction retourne un code d’erreur système.

Remarques

Le nom du cluster est stocké dans la propriété privée Name de la ressource principale Nom du réseau (autrement dit, la ressource Nom du réseau du cluster). En raison de dépendances possibles par rapport à cette ressource, la modification n’est pas effective tant que la ressource Nom du réseau n’est pas remise en ligne.

N’appelez pas SetClusterName à partir d’une DLL de ressource. 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	clusapi.h
Bibliothèque	ClusAPI.lib
DLL	ClusAPI.dll

Voir aussi

Nom

Partager via