Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

CreateClusterNotifyPortV2 function

Creates or modifies a notification port. For information about notification ports, see Receiving Cluster Events.

Syntax


HCHANGE WINAPI CreateClusterNotifyPortV2(
  _In_ HCHANGE                hChange,
  _In_ HCLUSTER               hCluster,
  _In_ NOTIFY_FILTER_AND_TYPE *Filters,
  _In_ DWORD                  dwFilterCount,
  _In_ DWORD_PTR              dwNotifyKey
);

typedef HCHANGE (WINAPI *PCLUSAPI_CREATE_CLUSTER_NOTIFY_PORT_V2)(
    _In_ HCHANGE                hChange,
    _In_ HCLUSTER               hCluster,
    _In_ NOTIFY_FILTER_AND_TYPE *Filters,
    _In_ DWORD                  dwFilterCount,
    _In_ DWORD_PTR              dwNotifyKey
);

Parameters

hChange [in]

A handle to a notification port or INVALID_HANDLE_VALUE, indicating that a new handle should be created. If the hChange parameter is an existing handle, the events that are specified in the dwFilter parameter are added to the notification port.

hCluster [in]

A handle to the cluster to be associated with the notification port that is identified by the hChange parameter or INVALID_HANDLE_VALUE, indicating that the notification port should not be associated with a cluster. If the hChange parameter is not set to INVALID_HANDLE_VALUE, the hCluster parameter cannot be set to INVALID_HANDLE_VALUE.

Filters [in]

A pointer to the NOTIFY_FILTER_AND_TYPE structure that specifies the type of notifications that the port can accept.

dwFilterCount [in]

The number of filters that are specified by the Filters parameter.

dwNotifyKey [in]

A user-specified value to associate with the retrieval of notifications from the notification port. The dwNotifyKey parameter is returned from GetClusterNotifyV2 when an event of one of the types that are specified in Filters occurs.

Return value

If the operation succeeds, the function returns a notification port handle.

If the operation fails, the function returns NULL. For more information about the error, call GetLastError.

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2012

Header

ClusAPI.h

Library

ClusAPI.lib

DLL

ClusAPI.dll

See also

Failover Cluster Management Function

 

 

Show: