Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Agrega un tipo de evento a la lista de eventos almacenados para un puerto de notificación. El tipo PCLUSAPI_REGISTER_CLUSTER_NOTIFY define un puntero a esta función.
Sintaxis
DWORD RegisterClusterNotify(
[in] HCHANGE hChange,
[in] DWORD dwFilterType,
[in] HANDLE hObject,
[in] DWORD_PTR dwNotifyKey
);
Parámetros
[in] hChange
Controle un puerto de notificación creado con la función CreateClusterNotifyPort .
[in] dwFilterType
Máscara de bits de marcas que describe el evento que se va a agregar al conjunto de eventos que está supervisando actualmente el puerto de notificación. Para obtener más información sobre estos tipos de eventos, vea CreateClusterNotifyPort. El parámetro dwFilterType se puede establecer en una de las siguientes marcas.
CLUSTER_CHANGE_CLUSTER_PROPERTY (0x40000000)
La cola recibe una notificación cuando cambia la lista prioritaria del clúster de redes internas.
CLUSTER_CHANGE_CLUSTER_RECONNECT
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. Esta notificación está reservada para uso futuro.
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 existente.
CLUSTER_CHANGE_GROUP_STATE (0x00001000)
La cola recibe una notificación cuando un grupo cambia de estado.
CLUSTER_CHANGE_HANDLE_CLOSE (0x80000000)
La cola recibe una notificación cuando se cierra un identificador para 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)
Esta notificación está reservada para uso futuro.
CLUSTER_CHANGE_NODE_STATE (0x00000001)
La cola recibe una notificación cuando un nodo cambia de estado.
CLUSTER_CHANGE_QUORUM_STATE (0x10000000)
La cola recibe una notificación cuando cambia el estado del recurso de cuórum .
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 .
CLUSTER_CHANGE_REGISTRY_NAME (0x00000010)
La cola recibe una notificación cuando se realiza un cambio en un nombre en la base de datos del clúster.
CLUSTER_CHANGE_REGISTRY_SUBTREE (0x00000080)
Indica que los demás eventos CLUSTER_CHANGE_REGISTRY se aplican a la raíz de la base de datos del clúster y a todas las subclaves. Si no se especifica CLUSTER_CHANGE_REGISTRY_SUBTREE, las notificaciones solo se aplican a la raíz.
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.
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)
Indica que se debe emitir una notificación cuando cambian las propiedades de un recurso.
CLUSTER_CHANGE_RESOURCE_STATE (0x00000100)
La cola recibe una notificación cuando un recurso cambia de estado.
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] hObject
Controle el objeto de clúster de conmutación por error afectado por el evento especificado en el parámetro dwFilterType . El tipo de identificador depende del valor de dwFilterType , tal y como se describe en la lista siguiente.
CLUSTER_CHANGE_CLUSTER_PROPERTY
HCLUSTER
CLUSTER_CHANGE_CLUSTER_STATE
HCLUSTER
CLUSTER_CHANGE_GROUP_DELETED
HGROUP
CLUSTER_CHANGE_GROUP_PROPERTY
HGROUP
CLUSTER_CHANGE_GROUP_STATE
HGROUP
CLUSTER_CHANGE_HANDLE_CLOSE
HCLUSTER, si la marca se usa por sí misma; de lo contrario, el identificador asociado a la marca con la que se combina CLUSTER_CHANGE_HANDLE_CLOSE se convierte en el tipo de identificador.
Por ejemplo, si el valor del parámetro dwFilterType es CLUSTER_CHANGE_GROUP_PROPERTY CLUSTER_CHANGE_HANDLE_CLOSE | , el tipo de identificador para el parámetro hObject se convierte en HGROUP, porque la marca CLUSTER_CHANGE_GROUP_PROPERTY está asociada al tipo de identificador HGROUP.
CLUSTER_CHANGE_NODE_DELETED
HNODE
CLUSTER_CHANGE_NODE_PROPERTY
HNODE
CLUSTER_CHANGE_NODE_STATE
HNODE
CLUSTER_CHANGE_REGISTRY_ATTRIBUTES
HKEY
CLUSTER_CHANGE_REGISTRY_NAME
HKEY
CLUSTER_CHANGE_REGISTRY_SUBTREE
HKEY
CLUSTER_CHANGE_REGISTRY_VALUE
HKEY
CLUSTER_CHANGE_RESOURCE_DELETED
HRESOURCE
CLUSTER_CHANGE_RESOURCE_PROPERTY
HRESOURCE
CLUSTER_CHANGE_RESOURCE_STATE
HRESOURCE
Las funciones de base de datos de clúster devuelven una clave de base de datos de clúster válida que se puede usar para establecer hObject cuando dwFilterType está establecido en un tipo de evento que afecta a la base de datos del clúster.
[in] dwNotifyKey
Clave de notificación devuelta desde GetClusterNotify cuando se produce el evento solicitado.
Valor devuelto
Si la operación se realiza correctamente, la función devuelve ERROR_SUCCESS.
Si se produce un error en la operación, la función devuelve un código de error del sistema.
Comentarios
La función RegisterClusterNotify permite que una aplicación que ya haya creado un puerto de notificación con CreateClusterNotifyPort se registre para un evento adicional que afecte a un nodo, un recurso o un grupo.
Para recibir notificaciones de cambios en la base de datos de clúster , se deben establecer una o varias marcas aplicables a la base de datos en el parámetro dwFilterType . Las marcas aplicables comienzan con el prefijo CLUSTER_CHANGE_REGISTRY. Al realizar cambios manuales en la base de datos del clúster a través del editor del Registro, RegEdit.exe, no se generan notificaciones.
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 |