CreateClusterNotifyPortV2, 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.
Syntaxe
HCHANGE CreateClusterNotifyPortV2(
[in] HCHANGE hChange,
[in] HCLUSTER hCluster,
[in] NOTIFY_FILTER_AND_TYPE *Filters,
[in] DWORD dwFilterCount,
[in] DWORD_PTR dwNotifyKey
);
Paramètres
[in] hChange
Handle vers un port de notification ou un INVALID_HANDLE_VALUE, indiquant qu’un nouveau handle doit être créé. Si le paramètre hChange est un handle existant, les événements spécifiés dans le paramètre dwFilter sont ajoutés au port de notification.
[in] hCluster
Handle du cluster à associer au port de notification identifié par le paramètre hChange ou INVALID_HANDLE_VALUE, indiquant que le port de notification ne doit pas être associé à un cluster. Si le paramètre hChange n’est pas défini sur INVALID_HANDLE_VALUE, le paramètre hCluster ne peut pas être défini sur INVALID_HANDLE_VALUE.
[in] Filters
Pointeur vers la structure NOTIFY_FILTER_AND_TYPE qui spécifie le type de notifications que le port peut accepter.
[in] dwFilterCount
Nombre de filtres spécifiés par le paramètre Filters .
[in] dwNotifyKey
Valeur spécifiée par l’utilisateur à associer à la récupération des notifications à partir du port de notification. Le paramètre dwNotifyKey est retourné par GetClusterNotifyV2 lorsqu’un événement de l’un des types spécifiés dans Filtres 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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Aucun pris en charge |
| Serveur minimal pris en charge | Windows Server 2012 |
| Plateforme cible | Windows |
| En-tête | clusapi.h |
| Bibliothèque | ClusAPI.lib |
| DLL | ClusAPI.dll |