Funzione ClusterRegBatchAddCommand (clusapi.h)

Articolo
02/26/2024

Aggiunge un comando a un batch che verrà eseguito in una chiave del Registro di sistema del cluster. Le chiamate aggiuntive alla funzione restituiranno comandi aggiuntivi aggiunti al batch. Il batch è stato creato dalla funzione ClusterRegCreateBatch e verrà eseguito o ignorato dalla funzione ClusterRegCloseBatch .

Sintassi

LONG ClusterRegBatchAddCommand(
  [in]           HREGBATCH           hRegBatch,
  [in]           CLUSTER_REG_COMMAND dwCommand,
  [in, optional] LPCWSTR             wzName,
  [in]           DWORD               dwOptions,
  [in, optional] VOID const          *lpData,
  [in]           DWORD               cbData
);

Parametri

[in] hRegBatch

Handle del batch a cui verrà aggiunto un comando.

[in] dwCommand

Comando supportato da questa API ottenuta dall'enumerazione CLUSTER_REG_COMMAND . I comandi possibili sono i seguenti.

CLUSREG_SET_VALUE (1)

Imposta un valore relativo all'ultimo comando CLUSREG_CREATE_KEY eseguito o (se non specificato) rispetto a una chiave passata alla funzione ClusterRegCreateBatch .

CLUSREG_CREATE_KEY (2)

Crea una chiave del Registro di sistema del cluster specificata se non esiste o apre una esistente.

CLUSREG_DELETE_KEY (3)

Elimina una chiave con tutti i valori e le sottochiave annidate. Nessun comando che opera sui valori può seguire CLUSREG_DELETE_KEY fino a quando non viene aggiunto CLUSREG_CREATE_KEY.

CLUSREG_DELETE_VALUE (4)

Elimina un valore relativo all'ultimo comando CLUSREG_CREATE_KEY eseguito o (se non specificato) rispetto a una chiave passata alla funzione ClusterRegCreateBatch .

[in, optional] wzName

Nome del valore o della chiave rispetto al comando rilasciato dal parametro dwCommand .

[in] dwOptions

Se dwCommand accetta il comando CLUSREG_SET_VALUE , questo parametro accetta uno dei tipi di valore del Registro di sistema standard. In caso contrario, dwCommand è impostato su 0.

[in, optional] lpData

Puntatore ai dati relativi al comando rilasciato da dwCommand. Il valore di questo parametro è NULL per tutti, ma il comando CLUSREG_SET_VALUE .

[in] cbData

Conteggio, in byte, dei dati relativi al comando rilasciato da dwCommand. Il valore di questo parametro è 0 per tutti, ma il comando CLUSREG_SET_VALUE .

Valore restituito

La funzione restituisce uno dei codici di errore di sistema seguenti.

Codice/valore restituito	Descrizione
ERROR_SUCCESS 0	L'operazione è stata completata.
ERROR_INVALID_FUNCTION 1	Funzione non corretta. Questo valore viene restituito se dwCommand accetta qualsiasi comando diverso dai comandi descritti nella sezione precedente.
ERROR_INVALID_HANDLE 6	L'handle non è valido. Questo valore viene restituito se il parametro hRegBatch è NULL.
ERROR_OUTOFMEMORY 14 (0xE)	Memoria disponibile insufficiente per completare l'operazione.
ERROR_GEN_FAILURE 31 (0x1F)	Un dispositivo collegato al sistema non funziona.
ERROR_INVALID_PARAMETER 87 (0x57)	Parametro non corretto. Questo valore verrà restituito se la chiave del Registro di sistema del cluster in cui il batch sta tentando di eseguire i comandi in non è la chiave corrente.

Commenti

Il tipo di PCLUSTER_REG_BATCH_ADD_COMMAND definisce un puntatore a questa funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2008 Datacenter, Windows Server 2008 Enterprise
Piattaforma di destinazione	Windows
Intestazione	clusapi.h
Libreria	ClusAPI.lib
DLL	ClusAPI.dll