共用方式為


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 會傳回其中一個 系統錯誤碼。 以下是可能的傳回值。

傳回碼/值 Description
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