알림 포트를 만들거나 수정합니다. 알림 포트에 대한 자세한 내용은 클러스터 이벤트 수신을 참조하세요. PCLUSAPI_CREATE_CLUSTER_NOTIFY_PORT 형식은 이 함수에 대한 포인터를 정의합니다.
구문
HCHANGE CreateClusterNotifyPort(
[in] HCHANGE hChange,
[in] HCLUSTER hCluster,
[in] DWORD dwFilter,
[in] DWORD_PTR dwNotifyKey
);
매개 변수
[in] hChange
새 핸들을 만들어야 함을 나타내는 알림 포트 또는 INVALID_HANDLE_VALUE 대한 핸들입니다. hChange가 기존 핸들인 경우 dwFilter에 지정된 이벤트가 알림 포트에 추가됩니다.
[in] hCluster
hChange로 식별된 알림 포트와 연결할 클러스터에 대한 핸들 또는 알림 포트를 클러스터와 연결해서는 안 함을 나타내는 INVALID_HANDLE_VALUE. hChange가 INVALID_HANDLE_VALUE 설정되지 않은 경우 hCluster를 INVALID_HANDLE_VALUE 설정할 수 없습니다.
[in] dwFilter
알림이 큐에 저장되도록 하는 이벤트를 지정하는 CLUSTER_CHANGE 열거형에서 열거된 플래그의 비트 마스크입니다. OR 연산자를 사용하여 다음 플래그 중 하나 이상을 설정하거나 값 CLUSTER_CHANGE_ALL 사용하여 모든 플래그를 지정할 수 있습니다.
CLUSTER_CHANGE_CLUSTER_PROPERTY(0x40000000)
큐는 클러스터의 속성이 변경될 때 알림을 받습니다.
CLUSTER_CHANGE_CLUSTER_RECONNECT(0x00080000)
잠시 연결을 끊은 후 hCluster 로 식별된 클러스터에 대한 연결이 다시 설정되면 큐에서 알림을 받습니다. 이 이벤트 전후에 생성된 일부 이벤트는 손실되었을 수 있습니다. 정확한 상태 정보를 받으려면 열려 있는 모든 연결을 닫고 다시 연결해야 합니다.
CLUSTER_CHANGE_CLUSTER_STATE(0x20000000)
클러스터를 사용할 수 없게 되면 큐에서 알림을 받습니다. 즉, 클러스터와 통신하려는 모든 시도가 실패합니다.
CLUSTER_CHANGE_GROUP_ADDED(0x00004000)
큐는 클러스터에 새 그룹을 만들 때 알림을 받습니다.
CLUSTER_CHANGE_GROUP_DELETED(0x00002000)
기존 그룹이 삭제되면 큐에서 알림을 받습니다.
CLUSTER_CHANGE_GROUP_PROPERTY(0x00008000)
큐는 그룹의 속성 이 변경되거나 리소스가 그룹에서 추가되거나 제거될 때 알림을 받습니다.
CLUSTER_CHANGE_GROUP_STATE(0x00001000)
큐는 그룹이 상태를 변경할 때 알림을 받습니다. 가능한 그룹 상태 값 목록은 GetClusterGroupState를 참조하세요.
CLUSTER_CHANGE_HANDLE_CLOSE(0x80000000)
클러스터 개체와 연결된 핸들이 닫혀 있으면 큐에서 알림을 받습니다.
CLUSTER_CHANGE_NETINTERFACE_ADDED(0x04000000)
새 네트워크 인터페이스 가 클러스터 노드에 추가되면 큐에서 알림을 받습니다.
CLUSTER_CHANGE_NETINTERFACE_DELETED(0x02000000)
네트워크 인터페이스가 클러스터 노드에서 영구적으로 제거되면 큐에서 알림을 받습니다.
CLUSTER_CHANGE_NETINTERFACE_PROPERTY(0x08000000)
큐는 기존 네트워크 인터페이스의 속성 이 변경될 때 알림을 받습니다.
CLUSTER_CHANGE_NETINTERFACE_STATE(0x01000000)
네트워크 인터페이스가 상태를 변경하면 큐에서 알림을 받습니다. 가능한 네트워크 인터페이스 상태 값 목록은 GetClusterNetInterfaceState를 참조하세요.
CLUSTER_CHANGE_NETWORK_ADDED(0x00400000)
새 네트워크가 클러스터 환경에 추가되면 큐에서 알림을 받습니다.
CLUSTER_CHANGE_NETWORK_DELETED(0x00200000)
네트워크가 클러스터 환경에서 영구적으로 제거되면 큐에서 알림을 받습니다.
CLUSTER_CHANGE_NETWORK_PROPERTY(0x00800000)
큐는 기존 네트워크의 속성 이 변경될 때 알림을 받습니다.
CLUSTER_CHANGE_NETWORK_STATE(0x00100000)
큐는 네트워크가 상태를 변경할 때 알림을 받습니다. 가능한 네트워크 상태 값 목록은 GetClusterNetworkState를 참조하세요.
CLUSTER_CHANGE_NODE_ADDED(0x00000004)
새 노드 가 클러스터에 추가되면 큐에서 알림을 받습니다. 클러스터 서비스가 노드에 처음 설치된 경우에만 노드를 추가할 수 있습니다.
CLUSTER_CHANGE_NODE_DELETED(0x00000002)
클러스터에서 노드가 영구적으로 제거되면 큐에서 알림을 받습니다. EvictClusterNode 함수를 호출하여 기존 클러스터에서 노드를 영구적으로 삭제할 수 있습니다.
CLUSTER_CHANGE_NODE_PROPERTY(0x00000008)
노드의 속성이 변경되면 큐에서 알림을 받습니다.
CLUSTER_CHANGE_NODE_STATE(0x00000001)
노드 상태가 변경되면 큐에서 알림을 받습니다. 가능한 노드 상태 값 목록은 GetClusterNodeState를 참조하세요.
CLUSTER_CHANGE_QUORUM_STATE(0x10000000)
이 알림은 나중에 사용할 수 있습니다.
CLUSTER_CHANGE_REGISTRY_ATTRIBUTES(0x00000020)
큐는 클러스터 데이터베이스 키의 특성이 변경될 때 알림을 받습니다. 현재 정의된 유일한 클러스터 데이터베이스 키 특성은 ClusterRegSetKeySecurity를 사용하여 변경할 수 있는 보안 설명자입니다.
CLUSTER_CHANGE_REGISTRY_NAME(0x00000010)
큐는 클러스터 데이터베이스 키의 이름이 변경되면 알림을 받습니다.
CLUSTER_CHANGE_REGISTRY_SUBTREE(0x00000080)
다른 CLUSTER_CHANGE_REGISTRY 이벤트가 전체 클러스터 데이터베이스에 적용됨을 나타냅니다. 이 플래그가 포함되지 않은 경우 이벤트는 지정된 키에만 적용됩니다.
CLUSTER_CHANGE_REGISTRY_VALUE(0x00000040)
지정된 클러스터 데이터베이스 키의 값이 변경되거나 삭제되면 큐에서 알림을 받습니다. ClusterRegSetValue 함수를 사용하여 클러스터 데이터베이스 값을 변경하고 ClusterRegDeleteValue 함수를 사용하여 삭제할 수 있습니다.
CLUSTER_CHANGE_RESOURCE_ADDED(0x00000400)
클러스터에 새 리소스 가 만들어지면 큐에서 알림을 받습니다.
CLUSTER_CHANGE_RESOURCE_DELETED(0x00000200)
리소스가 삭제되면 큐에서 알림을 받습니다.
CLUSTER_CHANGE_RESOURCE_PROPERTY(0x00000800)
리소스의 속성, 종속성 또는 가능한 소유자 노드가 변경되면 큐에서 알림을 받습니다.
CLUSTER_CHANGE_RESOURCE_STATE(0x00000100)
리소스 상태가 변경되면 큐에서 알림을 받습니다. 가능한 리소스 상태 값 목록은 GetClusterResourceState를 참조하세요.
CLUSTER_CHANGE_RESOURCE_TYPE_ADDED(0x00020000)
클러스터에 새 리소스 종류 가 만들어지면 큐에서 알림을 받습니다.
CLUSTER_CHANGE_RESOURCE_TYPE_DELETED(0x00010000)
기존 리소스 종류가 삭제되면 큐에서 알림을 받습니다.
CLUSTER_CHANGE_RESOURCE_TYPE_PROPERTY(0x00040000)
리소스 유형의 속성 이 변경되면 큐에서 알림을 받습니다.
[in] dwNotifyKey
알림 포트에서 알림을 검색하는 것과 연결할 사용자 지정 값입니다. dwNotifyKey는 dwFilter에 지정된 형식 중 하나의 이벤트가 발생하면 GetClusterNotify에서 반환됩니다.
반환 값
작업이 성공하면 함수는 알림 포트 핸들을 반환합니다.
작업이 실패하면 함수는 NULL을 반환합니다. 오류에 대한 자세한 내용은 GetLastError를 호출합니다.
설명
CreateClusterNotifyPort, GetClusterNotify 및 RegisterClusterNotify 함수 사용에 대한 자세한 내용은 클러스터 이벤트 수신을 참조하세요.
예제
알림 포트 예제를 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| 대상 플랫폼 | Windows |
| 헤더 | clusapi.h |
| 라이브러리 | ClusAPI.lib |
| DLL | ClusAPI.dll |