ClusterRegCloseBatch Function
Executes or ignores the batch created by the ClusterRegCreateBatch function.
Syntax
LONG ClusterRegCloseBatch(
__in HREGBATCH hRegBatch,
__in BOOL bCommit,
__out_opt INT *failedCommandNumber
);
Parameters
hRegBatch [in]
The handle of the cluster registry key opened by ClusterRegCreateBatch. After the completion of ClusterRegCloseBatch, this handle is no longer valid and memory associated with it is freed.bCommit [in]
If the value this parameter takes is true, then a batch is sent for execution to a cluster server.failedCommandNumber [out, optional]
If execution of the batch is not successful, the number of the command that failed is returned in the form of a failedCommandNumber argument. The first command in the batch has number 0, the second has number 1, and so on.
Return Value
The function returns one of the following system error codes.
| Return code/value | Description |
|---|---|
ERROR_SUCCESS |
The operation was successful. |
ERROR_INVALID_HANDLE |
The handle is not valid. This value is returned if the hRegBatch parameter is NULL. |
Remarks
If a failure has occurred before any command was executed, the failedCommandNumber parameter is set to –1.
The PCLUSTER_REG_CLOSE_BATCH type defines a pointer to this function.
Requirements
| Minimum supported client | None supported |
| Minimum supported server | Windows Server 2008 Datacenter Edition, Windows Server 2008 Enterprise Edition |
| Header | ClusApi.h |
| Library | ClusApi.lib |
| DLL | ClusApi.dll |
See Also
Cluster Registry Access Functions
ClusterRegCreateBatch
ClusterRegBatchAddCommand
Send comments about this topic to Microsoft
Build date: 2/9/2009