CLUSTER_BATCH_COMMAND-Struktur (clusapi.h)

Artikel
02/26/2024

Stellt die Reihenfolge dar, in der aktuelle Batchbefehlsdaten an die ClusterRegBatchReadCommand-Funktion gesendet werden. Die Werte in der CLUSTER_BATCH_COMMAND-Struktur sind identisch mit Parametern, die an die ClusterRegBatchAddCommand-Funktion übergeben werden. Der einzige Unterschied besteht darin, dass für CLUSREG_DELETE_VALUE die Elemente dwOptions, lpData und cbData auf den zu löschenden Wert festgelegt sind, ähnlich wie beim Befehl CLUSREG_SET_VALUE .

Syntax

typedef struct _CLUSTER_BATCH_COMMAND {
  CLUSTER_REG_COMMAND Command;
  DWORD               dwOptions;
  LPCWSTR             wzName;
  BYTE const          *lpData;
  DWORD               cbData;
} CLUSTER_BATCH_COMMAND;

Member

Command

Ein Befehl, der von dieser API unterstützt wird und aus der CLUSTER_REG_COMMAND-Enumeration stammt. Die möglichen Befehle sind wie folgt:

CLUSREG_SET_VALUE (1)

Legt einen Wert relativ zum zuletzt ausgeführten CLUSREG_CREATE_KEY Befehl oder (falls nicht angegeben) relativ zu einem Schlüssel fest, der an die ClusterRegCreateBatch-Funktion übergeben wird.

CLUSREG_CREATE_KEY (2)

Erstellt einen angegebenen Clusterregistrierungsschlüssel, falls er nicht vorhanden ist, oder öffnet einen vorhandenen.

CLUSREG_DELETE_KEY (3)

Löscht einen Schlüssel mit allen Werten und geschachtelten Unterschlüsseln. Keine Befehle, die mit Werten arbeiten, können CLUSREG_DELETE_KEY folgen, bis CLUS_REG_CREATE_KEY hinzugefügt wird.

CLUSREG_DELETE_VALUE (4)

Löscht einen Wert relativ zum zuletzt ausgeführten CLUSREG_CREATE_KEY Befehl oder (falls nicht angegeben) relativ zu einem Schlüssel, der an die ClusterRegCreateBatch-Funktion übergeben wird.

CLUSREG_VALUE_DELETED (6)

Gibt an, ob ein bestimmter Clusterregistrierungswert gelöscht wurde oder ob die Daten dieses Clusterregistrierungswerts geändert wurden. Dieser Befehl wird nur über einen Benachrichtigungsport für Batchupdates zurückgegeben.

dwOptions

Wenn der Command-Member entweder den Befehl CLUSREG_SET_VALUE oder den Befehl CLUSREG_DELETE_VALUE verwendet, nimmt dieser Member einen der Standardmäßigen Registrierungswerttypen an. Andernfalls ist Command auf 0 festgelegt.

wzName

Der Name des Werts oder Schlüssels relativ zum Befehl, der von Command ausgegeben wird.

lpData

Ein Zeiger auf die Daten relativ zum Befehl, der von Command ausgegeben wird. Der Wert dieses Members ist null für alle Befehle außer den Befehlen CLUSREG_SET_VALUE und CLUSREG_DELETE_VALUE .

cbData

Die Anzahl der Daten in Byte relativ zum von Command ausgegebenen Befehl. Der Wert dieses Members ist 0 für alle Befehle außer den Befehlen CLUSREG_SET_VALUE und CLUSREG_DELETE_VALUE .

Hinweise

Die Zeiger wzName und lpData sind gültig, bis die Batchbenachrichtigung über die ClusterRegBatchCloseNotification-Funktion geschlossen wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008 Datacenter, Windows Server 2008 Enterprise
Kopfzeile	clusapi.h