Partager via


Fonction ClusterRegGetBatchNotification (clusapi.h)

Récupère la notification de lot. Une fois la notification par lot extraite, elle est interprétée via la fonction ClusterRegBatchReadCommand . Une fois la notification par lot traitée, elle doit être fermée via la fonction ClusterRegBatchCloseNotification .

Syntaxe

LONG ClusterRegGetBatchNotification(
  [in]  HREGBATCHPORT         hBatchNotify,
  [out] HREGBATCHNOTIFICATION *phBatchNotification
);

Paramètres

[in] hBatchNotify

Handle du port de notification par lot ouvert précédemment via la fonction ClusterRegCreateBatchNotifyPort .

[out] phBatchNotification

Handle de la notification par lot qui représente toutes les modifications au niveau ou en dessous de la clé de Registre de cluster intéressante qui se sont produites depuis le dernier appel à ClusterRegGetBatchNotification ou depuis l’ouverture du port de notification par lot.

Valeur retournée

La fonction retourne l’un des codes d’erreur système suivants.

Code/valeur de retour Description
ERROR_SUCCESS
0
L'opération a réussi.
ERROR_INVALID_DATA
13 (0xD)
Les données ne sont pas correctes.
ERROR_OUTOFMEMORY
14 (0xE)
Espace de stockage insuffisant pour terminer cette opération.
ERROR_GEN_FAILURE
31 (0x1F)
Un périphérique connecté au système ne fonctionne pas.

Remarques

Le type PCLUSTER_REG_GET_BATCH_NOTIFICATION définit un pointeur vers cette fonction.

Seules les fonctions du groupe de fonctions batch, telles que ClusterRegBatchAddCommand, génèrent une notification de modification du Registre. Une modification du Registre qui n’utilise pas l’une des commandes de la fonction batch ne génère pas de notification par lot.

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

Voir aussi

Fonctions d’accès au Registre de cluster

ClusterRegBatchCloseNotification

ClusterRegBatchReadCommand

ClusterRegCreateBatchNotifyPort