ClusterResourceTypeControl 函式 (clusapi.h)

起始影響 資源類型的作業。 執行的作業取決於傳遞至 dwControlCode 參數的控制程式代碼。

語法

DWORD ClusterResourceTypeControl(
  [in]            HCLUSTER hCluster,
  [in]            LPCWSTR  lpszResourceTypeName,
  [in, optional]  HNODE    hHostNode,
  [in]            DWORD    dwControlCode,
  [in, optional]  LPVOID   lpInBuffer,
  [in]            DWORD    nInBufferSize,
  [out, optional] LPVOID   lpOutBuffer,
  [in]            DWORD    nOutBufferSize,
  [out, optional] LPDWORD  lpBytesReturned
);

參數

[in] hCluster

包含 lpszResourceTypeName 中所識別之資源類型的叢集句柄。

[in] lpszResourceTypeName

NULL 終止 Unicode 字串的指標，其中包含要影響之資源類型的名稱。

[in, optional] hHostNode

處理裝載受影響資源類型的節點。

[in] dwControlCode

資源類型控制項程式代碼，指定要執行的作業。 如需與控件程式代碼相關聯的語法，請參閱
控制程式代碼架構 和下列主題：

• CLUSCTL_RESOURCE_TYPE_ENUM_COMMON_PROPERTIES
• CLUSCTL_RESOURCE_TYPE_ENUM_PRIVATE_PROPERTIES
• CLUSCTL_RESOURCE_TYPE_GET_CHARACTERISTICS
• CLUSCTL_RESOURCE_TYPE_GET_CLASS_INFO
• CLUSCTL_RESOURCE_TYPE_GET_COMMON_PROPERTIES
• CLUSCTL_RESOURCE_TYPE_GET_COMMON_PROPERTY_FMTS
• CLUSCTL_RESOURCE_TYPE_GET_COMMON_RESOURCE_PROPERTY_FMTS
• CLUSCTL_RESOURCE_TYPE_GET_CRYPTO_CHECKPOINTS
• CLUSCTL_RESOURCE_TYPE_GET_FLAGS
• CLUSCTL_RESOURCE_TYPE_GET_PRIVATE_PROPERTIES
• CLUSCTL_RESOURCE_TYPE_GET_PRIVATE_PROPERTY_FMTS
• CLUSCTL_RESOURCE_TYPE_GET_PRIVATE_RESOURCE_PROPERTY_FMTS
• CLUSCTL_RESOURCE_TYPE_GET_REGISTRY_CHECKPOINTS
• CLUSCTL_RESOURCE_TYPE_GET_REQUIRED_DEPENDENCIES
• CLUSCTL_RESOURCE_TYPE_GET_RO_COMMON_PROPERTIES
• CLUSCTL_RESOURCE_TYPE_GET_RO_PRIVATE_PROPERTIES
• CLUSCTL_RESOURCE_TYPE_QUERY_DELETE
• CLUSCTL_RESOURCE_TYPE_SET_COMMON_PROPERTIES
• CLUSCTL_RESOURCE_TYPE_SET_PRIVATE_PROPERTIES
• CLUSCTL_RESOURCE_TYPE_STORAGE_GET_AVAILABLE_DISKS
• CLUSCTL_RESOURCE_TYPE_STORAGE_GET_RESOURCEID
• CLUSCTL_RESOURCE_TYPE_UNKNOWN
• CLUSCTL_RESOURCE_TYPE_VALIDATE_COMMON_PROPERTIES
• CLUSCTL_RESOURCE_TYPE_VALIDATE_PRIVATE_PROPERTIES

[in, optional] lpInBuffer

輸入緩衝區的指標，其中包含作業所需的資訊，如果不需要任何資訊， 則為 NULL 。

[in] nInBufferSize

lpInBuffer 所指向之緩衝區中的位元組數目。

[out, optional] lpOutBuffer

輸出緩衝區的指標，其中包含作業所產生的資訊，如果沒有傳回任何內容，則 為 NULL 。

[in] nOutBufferSize

lpOutBuffer 所指向輸出緩衝區中的位元組數目，如果呼叫端不知道將傳回多少數據，則為零。

[out, optional] lpBytesReturned

lpOutBuffer 所指向之緩衝區中位元組數目的指標，這些位元組實際上因為作業而填入。 如果 ClusterResourceTypeControl 不需要傳回輸出緩衝區中的位元組數目，則呼叫端可以傳遞 lpBytesReturned 的 NULL。

傳回值

函式會傳回下列其中一個值。

傳回碼	Description
ERROR_SUCCESS	作業成功。 如果作業需要輸出緩衝區，如果輸入) 上不是 NULL，則 lpBytesReturned (會指向緩衝區中傳回之數據的實際大小。
ERROR_MORE_DATA	lpOutBuffer 所指向的輸出緩衝區不夠大，無法保存作業所產生的數據。 如果輸入) 上不是 NULL，則 lpBytesReturned 參數 (指向輸出緩衝區所需的大小。 只有需要輸出緩衝區傳回 ERROR_MORE_DATA的作業。 如果 lpOutBuffer 參數為 NULL ，且 nOutBufferSize 參數為零，則可能會傳回 ERROR_SUCCESS ，而不是 ERROR_MORE_DATA。
系統錯誤碼	作業未成功。 如果作業需要輸出緩衝區， 則 lpBytesReturned 所指定的值不可靠。

備註

當 ClusterResourceTypeControl 傳回ERROR_MORE_DATA時，請將 nOutBufferSize 設定為 lpBytesReturned 所指向的位元組數目，然後再次呼叫函式。

請勿將 LPC 和 RPC 句柄傳遞至相同的函數調用。 否則，呼叫將會引發 RPC 例外狀況，而且可能會有額外的破壞性影響。 如需如何建立 LPC 和 RPC 句柄的資訊，請參閱 LPC 和 RPC 句柄 和 OpenCluster。

ClusterResourceTypeControl 是其中一個 控件程式代碼函式。 如需控制程式代碼和控制程式碼函式的詳細資訊，請參閱 使用控件代碼。

規格需求

需求	值
最低支援的用戶端	都不支援
最低支援的伺服器	Windows Server 2008 Enterprise、Windows Server 2008 Datacenter
目標平台	Windows
標頭	clusapi.h
程式庫	ClusAPI.lib
Dll	ClusAPI.dll

另請參閱

OpenCluster

資源類型控制代碼