estrutura CLUSTER_BATCH_COMMAND (clusapi.h)

Representa a ordem na qual os dados de comando do lote atual são enviados para a função ClusterRegBatchReadCommand . Os valores na estrutura CLUSTER_BATCH_COMMAND são idênticos aos parâmetros passados para a função ClusterRegBatchAddCommand . A única diferença é que, para CLUSREG_DELETE_VALUE, os membros dwOptions, lpData e cbData são definidos como o valor que está sendo excluído, semelhante ao comando CLUSREG_SET_VALUE .

Sintaxe

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

Membros

Command

Um comando que é compatível com essa API e obtido da enumeração CLUSTER_REG_COMMAND . Os comandos possíveis são os seguintes.

CLUSREG_SET_VALUE (1)

Define um valor relativo ao último comando CLUSREG_CREATE_KEY executado ou (se não for fornecido) em relação a uma chave passada para a função ClusterRegCreateBatch .

CLUSREG_CREATE_KEY (2)

Cria uma chave do Registro de cluster especificada se ela não existir ou abre uma existente.

CLUSREG_DELETE_KEY (3)

Exclui uma chave com todos os valores e subchaves aninhadas. Nenhum comando que opere em valores pode seguir CLUSREG_DELETE_KEY até que CLUS_REG_CREATE_KEY seja adicionado.

CLUSREG_DELETE_VALUE (4)

Exclui um valor relativo ao último comando CLUSREG_CREATE_KEY executado ou (se não fornecido) em relação a uma chave passada para a função ClusterRegCreateBatch .

CLUSREG_VALUE_DELETED (6)

Indica se um valor específico do registro de cluster foi excluído ou se os dados desse valor de registro de cluster foram alterados. Esse comando é retornado somente por meio de uma porta de notificação de atualização em lote.

dwOptions

Se o membro Command usar o comando CLUSREG_SET_VALUE ou o comando CLUSREG_DELETE_VALUE , esse membro usará um dos tipos de valor padrão do Registro. Caso contrário, Command será definido como 0.

wzName

O nome do valor ou da chave em relação ao comando emitido pelo Command.

lpData

Um ponteiro para os dados relativos ao comando emitido pelo Command. O valor desse membro é NULL para todos os comandos, exceto os comandos CLUSREG_SET_VALUE e CLUSREG_DELETE_VALUE .

cbData

A contagem, em bytes, dos dados relativos ao comando emitido pelo Command. O valor desse membro é 0 para todos os comandos, exceto os comandos CLUSREG_SET_VALUE e CLUSREG_DELETE_VALUE .

Comentários

Os ponteiros wzName e lpData são válidos até que a notificação em lote seja fechada por meio da função ClusterRegBatchCloseNotification .

Requisitos

Confira também

CLUSTER_REG_COMMAND

ClusterRegBatchAddCommand

ClusterRegBatchCloseNotification

ClusterRegBatchReadCommand

ClusterRegCreateBatch

Estruturas de cluster de failover