ZwFlushKey, fonction (wdm.h)

  • Article

La routine ZwFlushKey force la validation d’une clé de Registre sur le disque.

Syntaxe

NTSYSAPI NTSTATUS ZwFlushKey(
  [in] HANDLE KeyHandle
);

Paramètres

[in] KeyHandle

Gérez la clé de Registre à vider sur le disque. Ce handle est créé par un appel réussi à ZwCreateKey ou ZwOpenKey.

Valeur retournée

ZwFlushKey retourne STATUS_SUCCESS si les informations de clé ont été transférées sur le disque, ou le code d’erreur approprié en cas d’échec.

Remarques

Vous pouvez vider les modifications apportées par ZwCreateKey ou ZwSetValueKey en appelant ZwFlushKey. Cette routine ne retourne pas tant que toutes les données modifiées associées à KeyHandle n’ont pas été écrites sur le disque. ZwFlushKey vide l’intégralité de la ruche de Registre pour la clé, qui inclut chaque sous-clé de la clé spécifiée.

Cette routine peut vider l’intégralité du registre. Par conséquent, il peut générer une grande quantité d’E/S. Étant donné que le système vide automatiquement les modifications de clé toutes les quelques secondes, vous avez rarement besoin d’appeler ZwFlushKey.

Pour plus d’informations sur l’utilisation des clés de Registre, consultez Utilisation du Registre dans un pilote.

Si l’appel à cette fonction se produit en mode utilisateur, vous devez utiliser le nom « NtFlushKey » au lieu de « ZwFlushKey ».

Pour les appels provenant de pilotes en mode noyau, les versions NtXxx et ZwXxx d’une routine Windows Native System Services peuvent se comporter différemment dans la façon dont elles gèrent et interprètent les paramètres d’entrée. Pour plus d’informations sur la relation entre les versions NtXxx et ZwXxx d’une routine, consultez Using Nt and Zw Versions of the Native System Services Routines.

Configuration requise

Condition requise Valeur
Plateforme cible Universal
En-tête wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Règles de conformité DDI HwStorPortProhibitedDDIs(storport), IrqlZwPassive(wdm), ZwRegistryCreate(storport),ZwRegistryCreate(storport), ZwRegistryCreate(wdm), ZwRegistryOpen(storport), ZwRegistryOpen(storport), ZwRegistryOpen(wdm)

Voir aussi

Utilisation des versions Nt et Zw des routines des services système natifs

ZwCreateKey

ZwOpenKey

ZwSetValueKey