RESOURCE_STATUS 구조체(resapi.h)
온라인 상태가 되거나 오프라인으로 전환되는 리소스 에 대한 정보를 포함합니다. 이 구조체는 콜백 함수 SetResourceStatus에 대한 매개 변수로 사용됩니다.
구문
typedef struct RESOURCE_STATUS {
CLUSTER_RESOURCE_STATE ResourceState;
DWORD CheckPoint;
DWORD WaitHint;
HANDLE EventHandle;
} RESOURCE_STATUS, *PRESOURCE_STATUS;
멤버
ResourceState
CLUSTER_RESOURCE_STATE 열거형으로 열거된 리소스의 상태를 설명하는 값입니다. 이 멤버의 가능한 값은 다음과 같습니다.
ClusterResourceStateUnknown(-1)
일반적으로 서버를 더 이상 사용할 수 없기 때문에 상태를 검색하는 동안 오류가 발생했습니다. 자세한 내용은 호출자가 GetLastError 함수를 호출해야 합니다.
ClusterResourceOnline(2)
리소스는 온라인 상태이며 사용할 수 있습니다.
ClusterResourceOffline(3)
리소스가 오프라인 상태이며 사용할 수 없습니다.
ClusterResourceFailed (4)
리소스가 실패했습니다.
ClusterResourceOnlinePending(129)
리소스가 온라인에 배치되는 중입니다. CheckPoint 멤버는 이 멤버의 이전 값보다 커야 합니다.
ClusterResourceOfflinePending(130)
리소스가 오프라인으로 전환되는 중입니다.
CheckPoint
상태 보고서에 새 플래그를 지정하기 위해 리소스 DLL에서 설정한 값입니다.
WaitHint
이 멤버는 현재 사용되지 않습니다.
EventHandle
리소스가 실패한 시기를 나타내는 이벤트에 대한 핸들입니다.
설명
리소스 DLL은 일반적으로 ResourceState 멤버를 ClusterResourceOnline 또는 ClusterResourceOffline으로 설정합니다. 그러나 ResourceState 가 ClusterResourceOnlinePending 또는 ClusterResourceOfflinePending으로 설정된 경우 CheckPoint 멤버는 CheckPoint에 대해 보고된 이전 값보다 커야 합니다.
리소스 DLL은 처음에 CheckPoint 를 0으로 설정한 다음 SetResourceStatus에 대한 각 호출에 대해 1씩 증분합니다. 리소스 모니터는CheckPoint의 현재 값을 이전 값과 비교하여 새 상태 보고서를 검색합니다. 값이 변경된 경우 리소스 모니터는 새 상태 정보를 읽습니다.
ResourceState 멤버에서 ClusterResourceUnknown 상태를 반환하기 전에 리소스 DLL은 SetLastError 함수를 호출해야 합니다.
리소스 DLL은 EventHandle 멤버를 리소스가 실패할 때 신호를 수신하는 핸들로 설정합니다.
자세한 내용은 리소스 DLL 구현을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| 머리글 | resapi.h |