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 반환합니다.
작업이 실패하면 이 함수는 다음 시스템 오류 코드 중 하나를 반환합니다.
반환 코드/값 | 설명 |
---|---|
|
hChange 매개 변수에 표시되는 핸들이 잘못되었거나 다른 스레드에 의해 닫혔습니다. |
|
알림이 성공적으로 반환되기 전에 통화 시간이 초과되었습니다. |
|
lpszName 매개 변수가 가리키는 버퍼가 결과를 저장할 만큼 크지 않습니다. lpcchName 매개 변수는 종료 null 문자를 제외하고 결과의 문자 수를 반환합니다. |
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | 지원되는 버전 없음 |
지원되는 최소 서버 | Windows Server 2012 |
대상 플랫폼 | Windows |
헤더 | clusapi.h |
라이브러리 | ClusAPI.lib |
DLL | ClusAPI.dll |