Функция ZwFlushKey (wdm.h)

Подпрограмма ZwFlushKey принудительно фиксирует раздел реестра на диске.

Синтаксис

NTSYSAPI NTSTATUS ZwFlushKey(
  [in] HANDLE KeyHandle
);

Параметры

[in] KeyHandle

Дескриптор раздела реестра для записи на диск. Этот дескриптор создается путем успешного вызова ZwCreateKey или ZwOpenKey.

Возвращаемое значение

ZwFlushKey возвращает STATUS_SUCCESS, если сведения о ключе были переданы на диск, или соответствующий код ошибки при сбое.

Комментарии

Вы можете очистить изменения, внесенные ZwCreateKey или ZwSetValueKey , вызвав ZwFlushKey. Эта подпрограмма не возвращается, пока все измененные данные, связанные с KeyHandle , не будут записаны на диск. ZwFlushKey очищает весь куст реестра для ключа, который включает все подразделы указанного раздела.

Эта подпрограмма может очистить весь реестр. Соответственно, он может генерировать большое количество операций ввода-вывода. Так как система автоматически сбрасывает изменения ключа каждые несколько секунд, вам редко требуется вызывать ZwFlushKey.

Дополнительные сведения о работе с разделами реестра см. в статье Использование реестра в драйвере.

Если вызов этой функции выполняется в пользовательском режиме, следует использовать имя NtFlushKey вместо ZwFlushKey.

Для вызовов из драйверов режима ядра версии NtXxx и ZwXxx подпрограммы Собственные системные службы Windows могут вести себя по-разному, так как они обрабатывают и интерпретируют входные параметры. Дополнительные сведения о связи между версиями подпрограмм NtXxx и ZwXxx см. в разделе Использование версий NT и Zw подпрограмм собственных системных служб.

Требования

Требование	Значение
Целевая платформа	Универсальное
Верхняя часть	wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Правила соответствия DDI	HwStorPortProhibitedDIs(storport), IrqlZwPassive(wdm), ZwRegistryCreate(storport), ZwRegistryCreate(storport), ZwRegistryCreate(wdm), ZwRegistryOpen(storport), ZwRegistryOpen(storport), ZwRegistryOpen(storport), ZwRegistryOpen(wdm)

См. также раздел

Использование версий nt и Zw собственных системных служб

ZwCreateKey

ZwOpenKey

ZwSetValueKey