ClusterRegBatchAddCommand 函式 (clusapi.h)
將命令新增至將在叢集登錄機碼上執行的批次。 對函式的其他呼叫會產生新增至批次的其他命令。 批次是由 ClusterRegCreateBatch 函式所建立， 而且會由 ClusterRegCloseBatch 函式執行或忽略。
語法
LONG ClusterRegBatchAddCommand(
[in] HREGBATCH hRegBatch,
[in] CLUSTER_REG_COMMAND dwCommand,
[in, optional] LPCWSTR wzName,
[in] DWORD dwOptions,
[in, optional] VOID const *lpData,
[in] DWORD cbData
);
參數
[in] hRegBatch
將新增命令之批次的句柄。
[in] dwCommand
這個 API 支援的命令，取自 CLUSTER_REG_COMMAND 列舉。 可能的命令如下所示。
CLUSREG_SET_VALUE (1)
設定相對於上次執行 CLUSREG_CREATE_KEY 命令的值，如果未提供) 傳遞給 ClusterRegCreateBatch 函式的索引鍵，則 (。
CLUSREG_CREATE_KEY (2)
如果不存在，請建立指定的叢集登錄機碼，或開啟現有的登錄機碼。
CLUSREG_DELETE_KEY (3)
刪除具有所有值和巢狀子機碼的索引鍵。 在新增CLUSREG_CREATE_KEY之前，無法在CLUSREG_DELETE_KEY上操作任何命令。
CLUSREG_DELETE_VALUE (4)
如果未提供) 傳遞至 ClusterRegCreateBatch 函式的索引鍵，則刪除相對於上次執行CLUSREG_CREATE_KEY命令或 (的值。
[in, optional] wzName
相對於 dwCommand 參數所發出之命令的值或索引鍵名稱。
[in] dwOptions
如果 dwCommand 採用 CLUSREG_SET_VALUE 命令，則此參數會採用其中一個標準 登錄實值類型。 如果沒有， 則 dwCommand 會設定為 0。
[in, optional] lpData
相對於 dwCommand 所發出之命令的數據指標。 除了 CLUSREG_SET_VALUE 命令，此參數的值都是 NULL。
[in] cbData
相對於 dwCommand 所發出命令的數據計數，以位元組為單位。 除了 CLUSREG_SET_VALUE 命令，此參數的值為 0。
傳回值
函式會傳回下列其中一個 系統錯誤碼。
| 傳回碼/值 | Description |
|---|---|
|
作業成功。 |
|
不正確的函數。 如果 dwCommand 接受上一節所述的命令以外的任何命令，則會傳回此值。 |
|
句柄無效。 如果 hRegBatch 參數為 NULL，則會傳回此值。 |
|
儲存體不足，無法完成此作業。 |
|
連接至系統的裝置無法運作。 |
|
參數錯誤。 如果批次嘗試執行命令的叢集登錄機碼不是目前的機碼，則會傳回此值。 |
備註
PCLUSTER_REG_BATCH_ADD_COMMAND類型會定義此函式的指標。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 都不支援 |
| 最低支援的伺服器 | Windows Server 2008 Datacenter、Windows Server 2008 Enterprise |
| 目標平台 | Windows |
| 標頭 | clusapi.h |
| 程式庫 | ClusAPI.lib |
| Dll | ClusAPI.dll |