Función CreateClusterNotifyPort (clusapi.h)
Crea o modifica un puerto de notificación. Para obtener información sobre los puertos de notificación, consulte Recepción de eventos de clúster. El tipo PCLUSAPI_CREATE_CLUSTER_NOTIFY_PORT define un puntero a esta función.
Sintaxis
HCHANGE CreateClusterNotifyPort(
[in] HCHANGE hChange,
[in] HCLUSTER hCluster,
[in] DWORD dwFilter,
[in] DWORD_PTR dwNotifyKey
);
Parámetros
[in] hChange
Identificador de un puerto de notificación o INVALID_HANDLE_VALUE, lo que indica que se debe crear un nuevo identificador. Si hChange es un identificador existente, los eventos especificados en dwFilter se agregan al puerto de notificación.
[in] hCluster
Identificador del clúster que se va a asociar con el puerto de notificación identificado por hChange o INVALID_HANDLE_VALUE, lo que indica que el puerto de notificación no debe estar asociado a un clúster. Si hChange no está establecido en INVALID_HANDLE_VALUE, hCluster no se puede establecer en INVALID_HANDLE_VALUE.
[in] dwFilter
Máscara de bits de marcas enumeradas de la enumeración CLUSTER_CHANGE que especifica los eventos que harán que las notificaciones se almacenen en la cola. Se pueden establecer una o varias de las marcas siguientes mediante el operador OR, o bien puede especificar todas las marcas mediante el valor CLUSTER_CHANGE_ALL.
CLUSTER_CHANGE_CLUSTER_PROPERTY (0x40000000)
La cola recibe una notificación cuando cambian las propiedades del clúster.
CLUSTER_CHANGE_CLUSTER_RECONNECT (0x00080000)
La cola recibe una notificación cuando la conexión al clúster identificado por hCluster se restablece después de una breve desconexión. Es posible que se hayan perdido algunos eventos generados inmediatamente antes o después de este evento. Debe cerrar todas las conexiones abiertas y volver a conectarse para recibir información de estado precisa.
CLUSTER_CHANGE_CLUSTER_STATE (0x20000000)
La cola recibe una notificación cuando el clúster deja de estar disponible, lo que significa que todos los intentos de comunicarse con el clúster producen un error.
CLUSTER_CHANGE_GROUP_ADDED (0x00004000)
La cola recibe una notificación cuando se crea un nuevo grupo en el clúster.
CLUSTER_CHANGE_GROUP_DELETED (0x00002000)
La cola recibe una notificación cuando se elimina un grupo existente.
CLUSTER_CHANGE_GROUP_PROPERTY (0x00008000)
La cola recibe una notificación cuando cambian las propiedades de un grupo o cuando se agrega o quita un recurso de un grupo.
CLUSTER_CHANGE_GROUP_STATE (0x00001000)
La cola recibe una notificación cuando un grupo cambia de estado. Para obtener una lista de los posibles valores de estado de grupo, consulte GetClusterGroupState.
CLUSTER_CHANGE_HANDLE_CLOSE (0x80000000)
La cola recibe una notificación cuando se cierra un identificador asociado a un objeto de clúster .
CLUSTER_CHANGE_NETINTERFACE_ADDED (0x04000000)
La cola recibe una notificación cuando se agrega una nueva interfaz de red a un nodo de clúster.
CLUSTER_CHANGE_NETINTERFACE_DELETED (0x02000000)
La cola recibe una notificación cuando una interfaz de red se quita permanentemente de un nodo de clúster.
CLUSTER_CHANGE_NETINTERFACE_PROPERTY (0x08000000)
La cola recibe una notificación cuando cambian las propiedades de una interfaz de red existente.
CLUSTER_CHANGE_NETINTERFACE_STATE (0x01000000)
La cola recibe una notificación cuando una interfaz de red cambia de estado. Para obtener una lista de los posibles valores de estado de la interfaz de red, consulte GetClusterNetInterfaceState.
CLUSTER_CHANGE_NETWORK_ADDED (0x00400000)
La cola recibe una notificación cuando se agrega una nueva red al entorno del clúster.
CLUSTER_CHANGE_NETWORK_DELETED (0x00200000)
La cola recibe una notificación cuando una red se quita permanentemente del entorno del clúster.
CLUSTER_CHANGE_NETWORK_PROPERTY (0x00800000)
La cola recibe una notificación cuando cambian las propiedades de una red existente.
CLUSTER_CHANGE_NETWORK_STATE (0x00100000)
La cola recibe una notificación cuando una red cambia de estado. Para obtener una lista de los posibles valores de estado de red, consulte GetClusterNetworkState.
CLUSTER_CHANGE_NODE_ADDED (0x00000004)
La cola recibe una notificación cuando se agrega un nuevo nodo al clúster. Solo se puede agregar un nodo cuando el servicio de clúster se instala inicialmente en el nodo.
CLUSTER_CHANGE_NODE_DELETED (0x00000002)
La cola recibe una notificación cuando un nodo se quita permanentemente de un clúster. Un nodo se puede eliminar permanentemente de un clúster existente con una llamada a la función EvictClusterNode .
CLUSTER_CHANGE_NODE_PROPERTY (0x00000008)
La cola recibe una notificación cuando cambian las propiedades del nodo.
CLUSTER_CHANGE_NODE_STATE (0x00000001)
La cola recibe una notificación cuando un nodo cambia de estado. Para obtener una lista de los posibles valores de estado de nodo, consulte GetClusterNodeState.
CLUSTER_CHANGE_QUORUM_STATE (0x10000000)
Esta notificación está reservada para uso futuro.
CLUSTER_CHANGE_REGISTRY_ATTRIBUTES (0x00000020)
La cola recibe una notificación cuando se cambian los atributos de una clave de base de datos de clúster . El único atributo de clave de base de datos de clúster definido actualmente es su descriptor de seguridad, que se puede cambiar con ClusterRegSetKeySecurity.
CLUSTER_CHANGE_REGISTRY_NAME (0x00000010)
La cola recibe una notificación cuando el nombre de una clave de base de datos de clúster ha cambiado.
CLUSTER_CHANGE_REGISTRY_SUBTREE (0x00000080)
Indica que los demás eventos de CLUSTER_CHANGE_REGISTRY se aplican a toda la base de datos del clúster. Si no se incluye esta marca, los eventos solo se aplican a la clave especificada.
CLUSTER_CHANGE_REGISTRY_VALUE (0x00000040)
La cola recibe una notificación cuando se cambia o elimina un valor de la clave de base de datos de clúster especificada. Los valores de la base de datos de clúster se pueden cambiar con la función ClusterRegSetValue y eliminarse con la función ClusterRegDeleteValue .
CLUSTER_CHANGE_RESOURCE_ADDED (0x00000400)
La cola recibe una notificación cuando se crea un nuevo recurso en el clúster.
CLUSTER_CHANGE_RESOURCE_DELETED (0x00000200)
La cola recibe una notificación cuando se elimina un recurso.
CLUSTER_CHANGE_RESOURCE_PROPERTY (0x00000800)
La cola recibe una notificación cuando cambian las propiedades, las dependencias o los posibles nodos propietarios de un recurso.
CLUSTER_CHANGE_RESOURCE_STATE (0x00000100)
La cola recibe una notificación cuando un recurso cambia de estado. Para obtener una lista de los posibles valores de estado de recurso, consulte GetClusterResourceState.
CLUSTER_CHANGE_RESOURCE_TYPE_ADDED (0x00020000)
La cola recibe una notificación cuando se crea un nuevo tipo de recurso en el clúster.
CLUSTER_CHANGE_RESOURCE_TYPE_DELETED (0x00010000)
La cola recibe una notificación cuando se elimina un tipo de recurso existente.
CLUSTER_CHANGE_RESOURCE_TYPE_PROPERTY (0x00040000)
La cola recibe una notificación cuando cambian las propiedades de un tipo de recurso.
[in] dwNotifyKey
Valor especificado por el usuario que se va a asociar a la recuperación de notificaciones desde el puerto de notificación. DwNotifyKey se devuelve de GetClusterNotify cuando se produce un evento de uno de los tipos especificados en dwFilter.
Valor devuelto
Si la operación se realiza correctamente, la función devuelve un identificador de puerto de notificación.
Si se produce un error en la operación, la función devuelve NULL. Para obtener más información sobre el error, llame a GetLastError.
Comentarios
Para obtener más información sobre el uso de CreateClusterNotifyPort, GetClusterNotify y RegisterClusterNotify, funciones, consulte Recepción de eventos de clúster.
Ejemplos
Consulte el ejemplo de puerto de notificación.
Requisitos
| Cliente mínimo compatible | No se admite ninguno |
| Servidor mínimo compatible | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| Plataforma de destino | Windows |
| Encabezado | clusapi.h |
| Library | ClusAPI.lib |
| Archivo DLL | ClusAPI.dll |