CreateClusterNotifyPortV2 함수(clusapi.h)

알림 포트를 만들거나 수정합니다. 알림 포트에 대한 자세한 내용은 클러스터 이벤트 수신을 참조하세요.

구문

HCHANGE CreateClusterNotifyPortV2(
  [in] HCHANGE                hChange,
  [in] HCLUSTER               hCluster,
  [in] NOTIFY_FILTER_AND_TYPE *Filters,
  [in] DWORD                  dwFilterCount,
  [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] Filters

포트에서 허용할 수 있는 알림 유형을 지정하는 NOTIFY_FILTER_AND_TYPE 구조체에 대한 포인터입니다.

[in] dwFilterCount

Filters 매개 변수로 지정된 필터 수 입니다.

[in] dwNotifyKey

알림 포트에서 알림 검색과 연결할 사용자 지정 값입니다. 필터에 지정된 형식 중 하나의 이벤트가 발생하면 GetClusterNotifyV2에서 dwNotifyKey 매개 변수가 반환됩니다.

반환 값

작업이 성공하면 함수는 알림 포트 핸들을 반환합니다.

작업이 실패하면 함수는 NULL을 반환합니다. 오류에 대한 자세한 내용은 GetLastError를 호출합니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 지원되는 버전 없음
지원되는 최소 서버 Windows Server 2012
대상 플랫폼 Windows
헤더 clusapi.h
라이브러리 ClusAPI.lib
DLL ClusAPI.dll

추가 정보

장애 조치(failover) 클러스터 관리 함수