CreateClusterNotifyPort, fonction (clusapi.h)
Crée ou modifie un port de notification. Pour plus d’informations sur les ports de notification, consultez Réception d’événements de cluster. Le type PCLUSAPI_CREATE_CLUSTER_NOTIFY_PORT définit un pointeur vers cette fonction.
Syntaxe
HCHANGE CreateClusterNotifyPort(
[in] HCHANGE hChange,
[in] HCLUSTER hCluster,
[in] DWORD dwFilter,
[in] DWORD_PTR dwNotifyKey
);
Paramètres
[in] hChange
Gérez vers un port de notification ou un INVALID_HANDLE_VALUE, ce qui indique qu’un nouveau handle doit être créé. Si hChange est un handle existant, les événements spécifiés dans dwFilter sont ajoutés au port de notification.
[in] hCluster
Gérez le cluster à associer au port de notification identifié par hChange, ou INVALID_HANDLE_VALUE, en indiquant que le port de notification ne doit pas être associé à un cluster. Si hChange n’est pas défini sur INVALID_HANDLE_VALUE, hCluster ne peut pas être défini sur INVALID_HANDLE_VALUE.
[in] dwFilter
Masque de bits des indicateurs énumérés à partir de l’énumération CLUSTER_CHANGE qui spécifie les événements qui entraîneront le stockage des notifications dans la file d’attente. Un ou plusieurs des indicateurs suivants peuvent être définis à l’aide de l’opérateur OR, ou vous pouvez spécifier tous les indicateurs à l’aide de la valeur CLUSTER_CHANGE_ALL.
CLUSTER_CHANGE_CLUSTER_PROPERTY (0x40000000)
La file d’attente reçoit une notification lorsque les propriétés du cluster changent.
CLUSTER_CHANGE_CLUSTER_RECONNECT (0x00080000)
La file d’attente reçoit une notification lorsque la connexion au cluster identifié par hCluster est rétablie après une brève déconnexion. Certains événements générés immédiatement avant ou après cet événement peuvent avoir été perdus. Vous devez fermer toutes les connexions ouvertes et vous reconnecter pour recevoir des informations d’état précises.
CLUSTER_CHANGE_CLUSTER_STATE (0x20000000)
La file d’attente reçoit une notification lorsque le cluster devient indisponible, ce qui signifie que toutes les tentatives de communication avec le cluster échouent.
CLUSTER_CHANGE_GROUP_ADDED (0x00004000)
La file d’attente reçoit une notification lorsqu’un nouveau groupe est créé dans le cluster.
CLUSTER_CHANGE_GROUP_DELETED (0x00002000)
La file d’attente reçoit une notification lorsqu’un groupe existant est supprimé.
CLUSTER_CHANGE_GROUP_PROPERTY (0x00008000)
La file d’attente reçoit une notification lorsque les propriétés d’un groupe changent ou lorsqu’une ressource est ajoutée ou supprimée d’un groupe.
CLUSTER_CHANGE_GROUP_STATE (0x00001000)
La file d’attente reçoit une notification lorsqu’un groupe change d’état. Pour obtenir la liste des valeurs d’état de groupe possibles, consultez GetClusterGroupState.
CLUSTER_CHANGE_HANDLE_CLOSE (0x80000000)
La file d’attente reçoit une notification lorsqu’un handle associé à un objet de cluster est fermé.
CLUSTER_CHANGE_NETINTERFACE_ADDED (0x04000000)
La file d’attente reçoit une notification lorsqu’une nouvelle interface réseau est ajoutée à un nœud de cluster.
CLUSTER_CHANGE_NETINTERFACE_DELETED (0x02000000)
La file d’attente reçoit une notification lorsqu’une interface réseau est définitivement supprimée d’un nœud de cluster.
CLUSTER_CHANGE_NETINTERFACE_PROPERTY (0x08000000)
La file d’attente reçoit une notification lorsque les propriétés d’une interface réseau existante changent.
CLUSTER_CHANGE_NETINTERFACE_STATE (0x01000000)
La file d’attente reçoit une notification lorsqu’une interface réseau change d’état. Pour obtenir la liste des valeurs d’état d’interface réseau possibles, consultez GetClusterNetInterfaceState.
CLUSTER_CHANGE_NETWORK_ADDED (0x00400000)
La file d’attente reçoit une notification lorsqu’un nouveau réseau est ajouté à l’environnement de cluster.
CLUSTER_CHANGE_NETWORK_DELETED (0x00200000)
La file d’attente reçoit une notification lorsqu’un réseau est définitivement supprimé de l’environnement de cluster.
CLUSTER_CHANGE_NETWORK_PROPERTY (0x00800000)
La file d’attente reçoit une notification lorsque les propriétés d’un réseau existant changent.
CLUSTER_CHANGE_NETWORK_STATE (0x00100000)
La file d’attente reçoit une notification lorsqu’un réseau change d’état. Pour obtenir la liste des valeurs d’état réseau possibles, consultez GetClusterNetworkState.
CLUSTER_CHANGE_NODE_ADDED (0x00000004)
La file d’attente reçoit une notification lorsqu’un nouveau nœud est ajouté au cluster. Un nœud ne peut être ajouté que lorsque le service de cluster est initialement installé sur le nœud.
CLUSTER_CHANGE_NODE_DELETED (0x00000002)
La file d’attente reçoit une notification lorsqu’un nœud est supprimé définitivement d’un cluster. Un nœud peut être supprimé définitivement d’un cluster existant avec un appel à la fonction EvictClusterNode .
CLUSTER_CHANGE_NODE_PROPERTY (0x00000008)
La file d’attente reçoit une notification lorsque les propriétés du nœud changent.
CLUSTER_CHANGE_NODE_STATE (0x00000001)
La file d’attente reçoit une notification lorsqu’un nœud change d’état. Pour obtenir la liste des valeurs d’état de nœud possibles, consultez GetClusterNodeState.
CLUSTER_CHANGE_QUORUM_STATE (0x10000000)
Cette notification est réservée à une utilisation ultérieure.
CLUSTER_CHANGE_REGISTRY_ATTRIBUTES (0x00000020)
La file d’attente reçoit une notification lorsque les attributs d’une clé de base de données de cluster sont modifiés. Le seul attribut de clé de base de données de cluster actuellement défini est son descripteur de sécurité, qui peut être modifié avec ClusterRegSetKeySecurity.
CLUSTER_CHANGE_REGISTRY_NAME (0x00000010)
La file d’attente reçoit une notification lorsque le nom d’une clé de base de données de cluster a changé.
CLUSTER_CHANGE_REGISTRY_SUBTREE (0x00000080)
Indique que les autres événements CLUSTER_CHANGE_REGISTRY s’appliquent à l’ensemble de la base de données de cluster. Si cet indicateur n’est pas inclus, les événements s’appliquent uniquement à la clé spécifiée.
CLUSTER_CHANGE_REGISTRY_VALUE (0x00000040)
La file d’attente reçoit une notification lorsqu’une valeur de la clé de base de données de cluster spécifiée est modifiée ou supprimée. Les valeurs de base de données de cluster peuvent être modifiées avec la fonction ClusterRegSetValue et supprimées avec la fonction ClusterRegDeleteValue .
CLUSTER_CHANGE_RESOURCE_ADDED (0x00000400)
La file d’attente reçoit une notification lorsqu’une ressource est créée dans le cluster.
CLUSTER_CHANGE_RESOURCE_DELETED (0x00000200)
La file d’attente reçoit une notification lorsqu’une ressource est supprimée.
CLUSTER_CHANGE_RESOURCE_PROPERTY (0x00000800)
La file d’attente reçoit une notification lorsque les propriétés, les dépendances ou les nœuds propriétaires possibles d’une ressource changent.
CLUSTER_CHANGE_RESOURCE_STATE (0x00000100)
La file d’attente reçoit une notification lorsqu’une ressource change d’état. Pour obtenir la liste des valeurs d’état des ressources possibles, consultez GetClusterResourceState.
CLUSTER_CHANGE_RESOURCE_TYPE_ADDED (0x00020000)
La file d’attente reçoit une notification lorsqu’un nouveau type de ressource est créé dans le cluster.
CLUSTER_CHANGE_RESOURCE_TYPE_DELETED (0x00010000)
La file d’attente reçoit une notification lorsqu’un type de ressource existant est supprimé.
CLUSTER_CHANGE_RESOURCE_TYPE_PROPERTY (0x00040000)
La file d’attente reçoit une notification lorsque les propriétés d’un type de ressource changent.
[in] dwNotifyKey
Valeur spécifiée par l’utilisateur à associer à la récupération des notifications à partir du port de notification. DwNotifyKey est retourné par GetClusterNotify lorsqu’un événement de l’un des types spécifiés dans dwFilter se produit.
Valeur retournée
Si l’opération réussit, la fonction retourne un handle de port de notification.
Si l’opération échoue, la fonction retourne NULL. Pour plus d’informations sur l’erreur, appelez GetLastError.
Remarques
Pour plus d’informations sur l’utilisation des fonctions CreateClusterNotifyPort, GetClusterNotify et RegisterClusterNotify, consultez Réception d’événements de cluster.
Exemples
Consultez l’exemple de port de notification.
Configuration requise
| 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 |