ClusterRegCloseBatchEx function (clusapi.h)

Article
02/22/2024

Executes or ignores the batch created by the ClusterRegCreateBatch function.

Syntax

LONG ClusterRegCloseBatchEx(
  [in]            HREGBATCH hRegBatch,
  [in]            DWORD     flags,
  [out, optional] INT       *failedCommandNumber
);

Parameters

[in] hRegBatch

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.

[in] flags

[out, optional] failedCommandNumber

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 0	The operation was successful.
ERROR_INVALID_HANDLE 6	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.

Requirements

Requirement	Value
Minimum supported client	None supported
Minimum supported server	Windows Server 2012 R2
Target Platform	Windows
Header	clusapi.h
Library	ClusAPI.lib
DLL	ClusAPI.dll