다음을 통해 공유


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시스템 오류 코드 중 하나를 반환합니다. 다음은 가능한 반환 값입니다.

반환 코드/값 설명
ERROR_CIRCULAR_DEPENDENCY
1059(0x423)
리소스는 자체에 따라 달라집니다.
ERROR_DEPENDENCY_ALREADY_EXISTS
5003(0x138B)
리소스 종속성이 이미 있습니다.
ERROR_DEPENDENCY_NOT_ALLOWED
5069(0x13CD)
종속 리소스는 쿼럼입니다.
ERROR_INVALID_PARAMETER
87(0x57)
리소스가 동일한 그룹에 있지 않습니다.
ERROR_RESOURCE_NOT_AVAILABLE
5006(0x138E)
하나 이상의 리소스가 삭제로 표시됩니다.
ERROR_RESOURCE_ONLINE
5019(0x139B)
종속 리소스가 이미 온라인 상태입니다.

설명

AddClusterResourceDependency 함수에서 만든 종속성 관계는 실패 후 리소스를 한 노드에서 다른 노드로 이동하는 방법에 영향을 줍니다. 리소스가 오프라인으로 전환되고 다시 온라인 상태가 되는 순서를 결정합니다.

종속성 관계의 리소스를 함께 이동해야 합니다. 종속 리소스는 종속 리소스 다음에 온라인으로 가져와야 합니다.

hResourcehDependsOn으로 식별되는 두 리소스는 동일한 그룹에 있어야 합니다.

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

추가 정보

CanResourceBeDependent

OpenCluster

OpenClusterResource

RemoveClusterResourceDependency