GetClusterNotifyV2 함수(clusapi.h)

알림 포트에 대한 다음 알림 이벤트에 대한 정보를 검색합니다.

구문

DWORD GetClusterNotifyV2(
  [in]                HCHANGE                 hChange,
  [out]               DWORD_PTR               *lpdwNotifyKey,
  [in, out, optional] PNOTIFY_FILTER_AND_TYPE pFilterAndType,
  [in, out, optional] BYTE                    *buffer,
  [in, out, optional] LPDWORD                 lpbBufferSize,
  [in, out, optional] LPWSTR                  lpszObjectId,
  [in, out, optional] LPDWORD                 lpcchObjectId,
  [in, out, optional] LPWSTR                  lpszParentId,
  [in, out, optional] LPDWORD                 lpcchParentId,
  [in, out, optional] LPWSTR                  lpszName,
  [in, out, optional] LPDWORD                 lpcchName,
  [in, out, optional] LPWSTR                  lpszType,
  [in, out, optional] LPDWORD                 lpcchType,
  [in, optional]      DWORD                   dwMilliseconds
);

매개 변수

[in] hChange

알림 포트에 대한 핸들입니다. 이 핸들은 CreateClusterNotifyPortV2 함수에 의해 만들어집니다.

[out] lpdwNotifyKey

알림 포트에 대한 알림 키에 대한 포인터입니다.

[in, out, optional] pFilterAndType

알림 포트에 대한 다음 알림 이벤트를 설명하는 NOTIFY_FILTER_AND_TYPE 구조체에 대한 포인터입니다.

[in, out, optional] buffer

알림 이벤트의 버퍼에 대한 포인터입니다.

[in, out, optional] lpbBufferSize

버퍼 매개 변수의 크기에 대한 포인터(바이트)입니다.

[in, out, optional] lpszObjectId

이벤트를 트리거한 클러스터 개체의 ID가 있는 유니코드 문자열에 대한 포인터입니다. 문자열은 종료 null 문자로 끝납니다.

[in, out, optional] lpcchObjectId

입력 시 종료 null 문자를 포함하여 lpszObjectId 매개 변수가 보유할 수 있는 최대 문자 수를 지정하는 DWORD에 대한 포인터입니다. 출력에서 종료 null 문자를 제외하고 lpszObjectId가 받은 문자 수를 지정하는 DWORD에 대한 포인터입니다.

[in, out, optional] lpszParentId

이벤트를 트리거한 클러스터 개체에 대한 부모의 ID가 있는 유니코드 문자열에 대한 포인터입니다. 문자열은 종료 null 문자로 끝납니다.

[in, out, optional] lpcchParentId

입력 시 종료 null 문자를 포함하여 lpszParentId 매개 변수가 보유할 수 있는 최대 문자 수를 지정하는 DWORD에 대한 포인터입니다. 출력에서 종료되는 null 문자를 제외하고 lpszParentId가 받은 문자 수를 지정하는 DWORD에 대한 포인터입니다.

[in, out, optional] lpszName

이벤트를 트리거한 클러스터 개체의 이름을 포함하는 유니코드 문자열에 대한 포인터입니다. 문자열은 종료 null 문자로 끝납니다.

[in, out, optional] lpcchName

입력 시 종료 null 문자를 포함하여 lpszName 매개 변수가 보유할 수 있는 최대 문자 수를 지정하는 DWORD에 대한 포인터입니다. 출력에서 종료되는 null 문자를 제외하고 lpszName이 받은 문자 수를 지정하는 DWORD에 대한 포인터입니다.

[in, out, optional] lpszType

이벤트를 트리거한 클러스터 개체의 형식을 포함하는 유니코드 문자열에 대한 포인터입니다. 문자열은 종료 null 문자로 끝납니다.

[in, out, optional] lpcchType

입력 시 종료 null 문자를 포함하여 lpszType 매개 변수가 보유할 수 있는 최대 문자 수를 지정하는 DWORD에 대한 포인터입니다. 출력 시 종료 null 문자를 제외하고 lpszType이 받은 문자 수를 지정하는 DWORD에 대한 포인터입니다.

[in, optional] dwMilliseconds

호출자가 알림을 대기할 시간을 지정하는 시간 제한 값입니다.

반환 값

작업이 성공하면 이 함수는 ERROR_SUCCESS 반환합니다.

작업이 실패하면 이 함수는 다음 시스템 오류 코드 중 하나를 반환합니다.

반환 코드/값 설명
ERROR_INVALID_HANDLE
6
hChange 매개 변수에 표시되는 핸들이 잘못되었거나 다른 스레드에 의해 닫혔습니다.
WAIT_TIMEOUT
258(0x102)
알림이 성공적으로 반환되기 전에 통화 시간이 초과되었습니다.
ERROR_MORE_DATA
234(0xEA)
lpszName 매개 변수가 가리키는 버퍼가 결과를 저장할 만큼 크지 않습니다. lpcchName 매개 변수는 종료 null 문자를 제외하고 결과의 문자 수를 반환합니다.

요구 사항

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

추가 정보

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