AddClusterResourceDependency 함수(clusapi.h)
두 리소스 간에 종속성 관계를 만듭니 다. PCLUSAPI_ADD_CLUSTER_RESOURCE_DEPENDENCY 형식은 이 함수에 대한 포인터를 정의합니다.
구문
DWORD AddClusterResourceDependency(
[in] HRESOURCE hResource,
[in] HRESOURCE hDependsOn
);
매개 변수
[in] hResource
종속 리소스에 대한 핸들입니다.
[in] hDependsOn
hResource로 식별된 리소스가 의존해야 하는 리소스에 대한 핸들입니다.
반환 값
작업이 성공하면 ERROR_SUCCESS (0)을 반환합니다.
작업이 실패하면 AddClusterResourceDependency 는 시스템 오류 코드 중 하나를 반환합니다. 다음은 가능한 반환 값입니다.
반환 코드/값 | 설명 |
---|---|
|
리소스는 자체에 따라 달라집니다. |
|
리소스 종속성이 이미 있습니다. |
|
종속 리소스는 쿼럼입니다. |
|
리소스가 동일한 그룹에 있지 않습니다. |
|
하나 이상의 리소스가 삭제로 표시됩니다. |
|
종속 리소스가 이미 온라인 상태입니다. |
설명
AddClusterResourceDependency 함수에서 만든 종속성 관계는 실패 후 리소스를 한 노드에서 다른 노드로 이동하는 방법에 영향을 줍니다. 리소스가 오프라인으로 전환되고 다시 온라인 상태가 되는 순서를 결정합니다.
종속성 관계의 리소스를 함께 이동해야 합니다. 종속 리소스는 종속 리소스 다음에 온라인으로 가져와야 합니다.
hResource 및 hDependsOn으로 식별되는 두 리소스는 동일한 그룹에 있어야 합니다.
hResource가 이미 온라인인 경우 AddClusterResourceDependency를 호출하지 마세요. ERROR_RESOURCE_ONLINE 오류로 인해 호출이 실패합니다. 이 동작은 Windows Server 2008에서 변경되었습니다. 리소스를 오프라인으로 전환할 필요 없이 AddClusterResourceDependency 를 호출하고 리소스 종속성을 수정할 수 있습니다.
리소스 DLL에서 AddClusterResourceDependency 를 호출하지 마세요. 자세한 내용은 리소스 DLL에서 피해야 할 함수 호출을 참조하세요.
LPC 및 RPC 핸들을 동일한 함수 호출에 전달하지 마세요. 그렇지 않으면 호출은 RPC 예외를 발생시키고 추가적인 파괴적인 영향을 미칠 수 있습니다. LPC 및 RPC 핸들을 만드는 방법에 대한 자세한 내용은 개체 핸들 및 OpenCluster 사용을 참조하세요.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | 지원되는 버전 없음 |
지원되는 최소 서버 | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
대상 플랫폼 | Windows |
헤더 | clusapi.h |
라이브러리 | ClusAPI.lib |
DLL | ClusAPI.dll |