ClusterRegCreateBatch-Funktion (clusapi.h)

Erstellt einen Batch, der Befehle für einen Clusterregistrierungsschlüssel ausführt. Diese Befehle werden dem Batch von der ClusterRegBatchAddCommand-Funktion hinzugefügt und von der ClusterRegCloseBatch-Funktion entweder ausgeführt oder ignoriert.

Syntax

LONG ClusterRegCreateBatch(
  [in, optional] HKEY      hKey,
  [out]          HREGBATCH *pHREGBATCH
);

Parameter

[in, optional] hKey

Das Handle des geöffneten Clusterregistrierungsschlüssels. Alle Vorgänge für den Batch sind relativ zu diesem Clusterregistrierungsschlüssel.

[out] pHREGBATCH

Der Zeiger auf das Handle des erstellten Batches.

Rückgabewert

Die Funktion gibt einen der folgenden Systemfehlercodes zurück.

Rückgabecode/-wert	BESCHREIBUNG
ERROR_SUCCESS 0	Der Vorgang wurde durchgeführt.
ERROR_OUTOFMEMORY 14 (0xE)	Für diesen Vorgang ist nicht genügend Speicher verfügbar.
ERROR_GEN_FAILURE 31 (0x1F)	Ein an das System angeschlossenes Gerät funktioniert nicht.
ERROR_INVALID_PARAMETER 87 (0x57)	„Der Parameter ist falsch.“ Dieser Wert wird zurückgegeben, wenn der hKey-ParameterNULL ist.

Hinweise

Der Schlüssel sollte erst geschlossen werden, wenn der Batch zur Ausführung übermittelt wurde.

Der PCLUSTER_REG_CREATE_BATCH-Typ definiert einen Zeiger auf diese Funktion.

Anforderungen

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

ClusterRegCloseBatch