Fonction ClusterRegCloseBatch (clusapi.h)
Exécute ou ignore le lot créé par la fonction ClusterRegCreateBatch .
Syntaxe
LONG ClusterRegCloseBatch(
[in] HREGBATCH hRegBatch,
[in] BOOL bCommit,
[out, optional] INT *failedCommandNumber
);
Paramètres
[in] hRegBatch
Handle de la clé de Registre de cluster ouverte par ClusterRegCreateBatch. Une fois clusterRegCloseBatch terminé, ce handle n’est plus valide et la mémoire associée est libérée.
[in] bCommit
Si la valeur de ce paramètre est true, un lot est envoyé pour exécution à un serveur de cluster.
[out, optional] failedCommandNumber
Si l’exécution du lot échoue, le numéro de la commande qui a échoué est retourné sous la forme d’un argument failedCommandNumber . La première commande du lot a le numéro 0, la seconde a le numéro 1, et ainsi de suite.
Valeur retournée
La fonction retourne l’un des codes d’erreur système suivants.
| Code/valeur de retour | Description |
|---|---|
|
L'opération a réussi. |
|
Le handle n’est pas valide. Cette valeur est retournée si le paramètre hRegBatch a la valeur NULL. |
Remarques
Si un échec s’est produit avant l’exécution d’une commande, le paramètre failedCommandNumber est défini sur –1.
Le type PCLUSTER_REG_CLOSE_BATCH définit un pointeur vers cette fonction.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Aucun pris en charge |
| Serveur minimal pris en charge | Windows Server 2008 Datacenter, Windows Server 2008 Entreprise |
| Plateforme cible | Windows |
| En-tête | clusapi.h |
| Bibliothèque | ClusAPI.lib |
| DLL | ClusAPI.dll |