CLUSTER_BATCH_COMMAND 構造体 (clusapi.h)
現在のバッチ コマンド データが ClusterRegBatchReadCommand 関数に送信される順序を表します。 CLUSTER_BATCH_COMMAND構造体の値は、ClusterRegBatchAddCommand 関数に渡されるパラメーターと同じです。 唯一の違いは、 CLUSREG_DELETE_VALUEの 場合、dwOptions、 lpData、 cbData メンバーは、 CLUSREG_SET_VALUE コマンドと同様に、削除される値に設定されることです。
構文
typedef struct _CLUSTER_BATCH_COMMAND {
CLUSTER_REG_COMMAND Command;
DWORD dwOptions;
LPCWSTR wzName;
BYTE const *lpData;
DWORD cbData;
} CLUSTER_BATCH_COMMAND;
メンバー
Command
この API でサポートされ、 CLUSTER_REG_COMMAND 列挙から取得されたコマンド。 使用できるコマンドは次のとおりです。
CLUSREG_SET_VALUE (1)
ClusterRegCreateBatch 関数に渡されたキーに対して、最後に実行されたCLUSREG_CREATE_KEYコマンドまたは (指定されていない場合) に対して相対的な値を設定します。
CLUSREG_CREATE_KEY (2)
指定したクラスター レジストリ キーが存在しない場合は作成するか、既存のクラスター レジストリ キーを開きます。
CLUSREG_DELETE_KEY (3)
すべての値と入れ子になったサブキーを含むキーを削除します。 値を操作するコマンドは、 CLUS_REG_CREATE_KEY が追加されるまで CLUSREG_DELETE_KEY に従う必要はありません。
CLUSREG_DELETE_VALUE (4)
ClusterRegCreateBatch 関数に渡されたキーに対して、最後に実行されたCLUSREG_CREATE_KEYコマンドまたは (指定されていない場合) に対する相対値を削除します。
CLUSREG_VALUE_DELETED (6)
特定のクラスター レジストリ値が削除されたかどうか、またはそのクラスター レジストリ値のデータが変更されたかどうかを示します。 このコマンドは、バッチ更新通知ポートを介してのみ返されます。
dwOptions
Command メンバーが CLUSREG_SET_VALUE コマンドまたは CLUSREG_DELETE_VALUE コマンドを受け取る場合、このメンバーは標準のレジストリ値型のいずれかを受け取ります。 そうでない場合、 Command は 0 に設定されます。
wzName
Command によって発行されたコマンドに対する相対値またはキーの名前。
lpData
Command によって発行されたコマンドを基準としたデータへのポインター。 このメンバーの値は、CLUSREG_SET_VALUEコマンドと CLUSREG_DELETE_VALUE コマンドを除くすべてのコマンドに対して NULL です。
cbData
Command によって発行されたコマンドに対するデータのカウント (バイト単位)。 このメンバーの値は、CLUSREG_SET_VALUEコマンドとCLUSREG_DELETE_VALUE コマンドを除くすべてのコマンドに対して 0 です。
注釈
wzName ポインターと lpData ポインターは、ClusterRegBatchCloseNotification 関数を介してバッチ通知が閉じられるまで有効です。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2008 Datacenter、Windows Server 2008 Enterprise |
| Header | clusapi.h |