GetClusterResourceState 함수(clusapi.h)
리소스의 현재 상태를 반환합니다. PCLUSAPI_GET_CLUSTER_RESOURCE_STATE 형식은 이 함수에 대한 포인터를 정의합니다.
구문
CLUSTER_RESOURCE_STATE GetClusterResourceState(
[in] HRESOURCE hResource,
[out, optional] LPWSTR lpszNodeName,
[in, out, optional] LPDWORD lpcchNodeName,
[out, optional] LPWSTR lpszGroupName,
[in, out, optional] LPDWORD lpcchGroupName
);
매개 변수
[in] hResource
상태 정보를 반환할 리소스 지정을 처리합니다.
[out, optional] lpszNodeName
지정된 리소스의 현재 소유자 노드 이름을 NULL로 종료된 유니코드 문자열로 받는 버퍼에 대한 포인터입니다. 노드 이름이 필요하지 않은 경우 NULL 을 전달합니다.
[in, out, optional] lpcchNodeName
lpszNodeName 버퍼의 크기를 문자 수로 가리키는 포인터입니다. lpszNodeName도 NULL이 아니면 이 포인터는 NULL일 수 없습니다. 입력에서 종료 NULL을 포함하여 버퍼가 보유할 수 있는 최대 문자 수를 지정합니다. 출력에서 종료 되는 NULL을 제외하고 결과 이름의 문자 수를 지정합니다.
[out, optional] lpszGroupName
지정된 리소스를 포함하는 그룹의 이름을 받는 버퍼에 대한 포인터입니다. 이름은 NULL로 끝나는 유니코드 문자열로 반환됩니다. 그룹 이름이 필요하지 않은 경우 NULL 을 전달합니다.
[in, out, optional] lpcchGroupName
lpszGroupName 버퍼의 크기를 문자 수로 가리키는 포인터입니다. lpszNodeName도 NULL이 아니면 이 포인터는 NULL일 수 없습니다. 입력에서 종료 NULL을 포함하여 버퍼가 보유할 수 있는 최대 문자 수를 지정합니다. 출력에서 종료 되는 NULL을 제외하고 결과 이름의 문자 수를 지정합니다.
반환 값
GetClusterResourceState 는 다음 값 중 하나로 나타낼 수 있는 CLUSTER_RESOURCE_STATE 열거형에서 열거된 리소스의 현재 상태를 반환합니다.
| 반환 코드/값 | 설명 |
|---|---|
|
리소스가 초기화를 수행하고 있습니다. |
|
리소스가 정상적으로 작동하고 작동합니다. |
|
리소스가 작동되지 않습니다. 리소스가 ClusterResourceOffline (3) 또는 ClusterResourceCannotComeOnlineOnThisNode (127) 상태를 보고한 경우 이 값이 반환됩니다. |
|
리소스가 실패했습니다. 리소스가 ClusterResourceFailed (4) 또는 ClusterResourceCannotComeOnlineOnAnyNode (126) 상태를 보고한 경우 이 값이 반환됩니다. |
|
리소스가 온라인 상태가 되거나 오프라인으로 전환 중입니다. |
|
리소스가 온라인 상태가 되는 중입니다. |
|
리소스가 오프라인으로 전환 중입니다. |
|
작업이 성공하지 못했습니다. 오류에 대한 자세한 내용은 GetLastError 함수를 호출합니다. |
설명
리소스 DLL 진입점 함수에서 GetClusterResourceState 를 호출하지 마세요. GetClusterResourceState 는 작업자 스레드에서 안전하게 호출할 수 있습니다. 자세한 내용은 리소스 DLL에서 피해야 할 함수 호출을 참조하세요.
예제
예제 는 개체 상태 가져오기 를 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| 대상 플랫폼 | Windows |
| 헤더 | clusapi.h |
| 라이브러리 | ClusAPI.lib |
| DLL | ClusAPI.dll |