ClusterResourceControlAsUser 函式 (clusapi.h)
起始會影響 資源的作業。
執行的作業取決於傳遞至 dwControlCode 參數的控制程式代碼。
語法
DWORD ClusterResourceControlAsUser(
[in] HRESOURCE hResource,
[in, optional] HNODE hHostNode,
[in] DWORD dwControlCode,
[in, optional] LPVOID lpInBuffer,
[in] DWORD cbInBufferSize,
[out, optional] LPVOID lpOutBuffer,
[in] DWORD cbOutBufferSize,
[out, optional] LPDWORD lpBytesReturned
);
參數
[in] hResource
要受影響的資源句柄。
[in, optional] hHostNode
要執行作業之節點的選擇性句柄。 如果 為 NULL，則擁有 hResource 所識別資源的節點會執行作業。
[in] dwControlCode
資源控制程序代碼，由CLUSCTL_RESOURCE_CODES列舉，指定要執行的作業。 如需與控件程式代碼相關聯的語法，請參閱
CLUSCTL_RESOURCE_CODES主題上的連結。
[in, optional] lpInBuffer
輸入緩衝區的指標，其中包含作業所需的資訊，如果不需要任何資訊，則為 NULL 。
[in] cbInBufferSize
輸入緩衝區) 的已配置大小 (以位元組為單位。
[out, optional] lpOutBuffer
輸出緩衝區的指標，以接收作業所產生的數據，如果未傳回任何數據，則為 NULL 。
[in] cbOutBufferSize
輸出緩衝區的已配置大小 (位元組) 。
[out, optional] lpBytesReturned
傳回實際大小 (，以位元組為單位，) 作業所產生的數據。 如果不需要此資訊，請為 lpBytesReturned 傳遞 NULL。
傳回值
函式會傳回下列其中一個值。
| 傳回碼/值 | Description |
|---|---|
|
作業成功。 如果作業需要輸出緩衝區，則 lpBytesReturned (輸入) 指向緩衝區中傳回之數據的實際大小。 |
|
lpOutBuffer 指向的輸出緩衝區不夠大，無法保存作業所產生的數據。 如果輸入) 上不是 NULL，則 lpBytesReturned 參數 (指向輸出緩衝區所需的大小。 只有需要輸出緩衝區傳回 ERROR_MORE_DATA的作業。 如果 lpOutBuffer 參數為 NULL ，而 cbOutBufferSize 參數為零，則可能會傳回 ERROR_SUCCESS ，而不是 ERROR_MORE_DATA。 |
|
僅適用於 CLUSCTL_RESOURCE_SET_COMMON_PROPERTIES 和 CLUSCTL_RESOURCE_SET_PRIVATE_PROPERTIES。 表示屬性已成功儲存，但尚未套用至資源。 新的屬性會在資源離線後生效，並再次上線。 |
|
hNode 參數指定的節點不是擁有 hResource 所指定資源的節點。 |
| 作業未成功。 如果作業需要輸出緩衝區，則輸入) 上不是 NULL 時，由 lpBytesReturned 所指定的值 (不可靠。 |
備註
當 ClusterResourceControl 傳回 ERROR_MORE_DATA時，請將 cbOutBufferSize 設定為 lpBytesReturned 所指向的位元組數目，然後再次呼叫函式。
請勿將 LPC 和 RPC 句柄傳遞至相同的函數調用。 否則，呼叫將會引發 RPC 例外狀況，而且可能會有額外的破壞性影響。 如需如何建立 LPC 和 RPC 句柄的資訊，請參閱 LPC 和 RPC 句柄 和 OpenCluster。
ClusterResourceControl 函式是其中一個控制程式代碼函式。 如需控制程式代碼和控制程式碼函式的詳細資訊，請參閱 使用控件代碼。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 都不支援 |
| 最低支援的伺服器 | Windows Server 2016 |
| 目標平台 | Windows |
| 標頭 | clusapi.h |
| 程式庫 | ClusAPI.lib |
| Dll | ClusAPI.dll |