ClusterRegCloseBatch-Funktion (clusapi.h)

Führt den von der ClusterRegCreateBatch-Funktion erstellten Batch aus oder ignoriert diesen.

Syntax

LONG ClusterRegCloseBatch(
  [in]            HREGBATCH hRegBatch,
  [in]            BOOL      bCommit,
  [out, optional] INT       *failedCommandNumber
);

Parameter

[in] hRegBatch

Das Handle des Von ClusterRegCreateBatch geöffneten Clusterregistrierungsschlüssels. Nach Abschluss von ClusterRegCloseBatch ist dieses Handle nicht mehr gültig, und der zugeordnete Arbeitsspeicher wird freigegeben.

[in] bCommit

Wenn der Wert, den dieser Parameter annimmt, true ist, wird ein Batch zur Ausführung an einen Clusterserver gesendet.

[out, optional] failedCommandNumber

Wenn die Ausführung des Batches nicht erfolgreich ist, wird die Nummer des fehlgeschlagenen Befehls in Form eines failedCommandNumber-Arguments zurückgegeben. Der erste Befehl im Batch hat die Zahl 0, der zweite die Zahl 1 usw.

Rückgabewert

Die Funktion gibt einen der folgenden Systemfehlercodes zurück.

Rückgabecode/-wert	BESCHREIBUNG
ERROR_SUCCESS 0	Der Vorgang wurde durchgeführt.
ERROR_INVALID_HANDLE 6	Das Handle ist ungültig. Dieser Wert wird zurückgegeben, wenn der hRegBatch-ParameterNULL ist.

Hinweise

Wenn ein Fehler aufgetreten ist, bevor ein Befehl ausgeführt wurde, wird der failedCommandNumber-Parameter auf –1 festgelegt.

Der PCLUSTER_REG_CLOSE_BATCH Typ definiert einen Zeiger auf diese Funktion.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008 Datacenter, Windows Server 2008 Enterprise
Zielplattform	Windows
Kopfzeile	clusapi.h
Bibliothek	ClusAPI.lib
DLL	ClusAPI.dll

Weitere Informationen

Clusterregistrierungszugriffsfunktionen

ClusterRegBatchAddCommand

ClusterRegCloseBatchEx

ClusterRegCreateBatch