CRegKey::NotifyChangeKeyValue
Cette méthode signale l'appelant sur les modifications apportées aux attributs ou au contenu de la clé de Registre ouverte.
LONG NotifyChangeKeyValue(
BOOL bWatchSubtree,
DWORD dwNotifyFilter,
HANDLE hEvent,
BOOL bAsync = TRUE
) throw( );
Paramètres
bWatchSubtree
Spécifie une balise qui indique si enregistrer des modifications dans la clé spécifiée et toutes ses sous-clés ou uniquement de la clé spécifiée. Si ce paramètre est VRAI, la méthode signale les modifications de la clé et de ses sous-clés. Si le paramètre est FAUX, la méthode signale les modifications uniquement de la clé.dwNotifyFilter
Spécifie un jeu d'indicateurs qui contrôlent qui passe doit être signalé. Ce paramètre peut être une combinaison des valeurs suivantes :Valeur
Signification
REG_NOTIFY_CHANGE_NAME
Avertit l'appelant si une sous-clé est ajoutée ou supprimée.
REG_NOTIFY_CHANGE_ATTRIBUTES
Avertit l'appelant les modifications apportées aux attributs de la clé, tels que les informations de modèle de sécurité.
REG_NOTIFY_CHANGE_LAST_SET
Avertit l'appelant des modifications à une valeur de clé. Cela peut inclure l'ajout ou la suppression d'une valeur, ou modifier une valeur existante.
REG_NOTIFY_CHANGE_SECURITY
Avertit l'appelant des modifications au modèle de sécurité de la clé.
hEvent
Handle à un événement. Si le paramètre de bAsync est VRAI, la méthode retourne immédiatement et les modifications sont stockées dans des signaux cet événement. Si bAsync est FAUX, hEvent est ignoré.bAsync
Spécifie une balise qui indique comment la méthode signale les modifications. Si ce paramètre est VRAI, la méthode retourne immédiatement et les rapports des signaux change lorsque l'événement spécifié. Lorsque ce paramètre est FAUX, la méthode ne retourne pas jusqu'à ce qu'une modification se soit produite. Si hEvent ne spécifie pas d'événement valide, le paramètre d' bAsync ne peut pas être VRAI.
Valeur de retour
Si la méthode réussit, la valeur de retour est ERROR_SUCCESS. Si la méthode échoue, la valeur de retour est un code d'erreur différent de zéro défini dans WINERROR.H.
Notes
Notes
Cette méthode ne signale pas l'appelant si la clé spécifiée est désactivée.
Pour plus d'informations et un exemple de programme, consultez RegNotifyChangeKeyValue.
Configuration requise
Header: atlbase.h