Función CreateClusterNotifyPortV2 (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.

Sintaxis

HCHANGE CreateClusterNotifyPortV2(
  [in] HCHANGE                hChange,
  [in] HCLUSTER               hCluster,
  [in] NOTIFY_FILTER_AND_TYPE *Filters,
  [in] DWORD                  dwFilterCount,
  [in] DWORD_PTR              dwNotifyKey
);

Parámetros

[in] hChange

Identificador de un puerto de notificación o INVALID_HANDLE_VALUE, que indica que se debe crear un nuevo identificador. Si el parámetro hChange es un identificador existente, los eventos especificados en el parámetro dwFilter se agregan al puerto de notificación.

[in] hCluster

Identificador del clúster que se va a asociar al puerto de notificación identificado por el parámetro hChange o INVALID_HANDLE_VALUE, lo que indica que el puerto de notificación no debe estar asociado a un clúster. Si el parámetro hChange no está establecido en INVALID_HANDLE_VALUE, el parámetro hCluster no se puede establecer en INVALID_HANDLE_VALUE.

[in] Filters

Puntero a la estructura NOTIFY_FILTER_AND_TYPE que especifica el tipo de notificaciones que el puerto puede aceptar.

[in] dwFilterCount

Número de filtros especificados por el parámetro Filters .

[in] dwNotifyKey

Valor especificado por el usuario que se va a asociar a la recuperación de notificaciones del puerto de notificación. El parámetro dwNotifyKey se devuelve de GetClusterNotifyV2 cuando se produce un evento de uno de los tipos especificados en Filters .

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.

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2012
Plataforma de destino	Windows
Encabezado	clusapi.h
Library	ClusAPI.lib
Archivo DLL	ClusAPI.dll

Consulte también

Función de administración de clústeres de conmutación por error