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 |
---|---|
|
資源取決於本身。 |
|
資源相依性已經存在。 |
|
相依資源是仲裁。 |
|
資源不在相同的群組中。 |
|
至少有一個資源標示為要刪除。 |
|
相依資源已在在線。 |
備註
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 |