NTSTATUS
ZwFlushKey(
IN HANDLE KeyHandle
);
ZwFlushKey forces a registry key to be committed to disk.
Parameters
KeyHandle
Is the handle, returned by a successful call to ZwCreateKey or ZwOpenKey, of the key to be flushed.
Return Value
ZwFlushKey returns STATUS_SUCCESS if the key information was transferred to disk.
Comments
Changes made by ZwCreateKey or ZwSetValueKey can be flushed to disk with ZwFlushKey. This routine does not return to its caller until any changed data associated with the given KeyHandle has been written to permanent store.
Note This routine can flush the entire registry. Accordingly, it can generate a great deal of I/O. Since the system automatically flushes key changes every few seconds, it is seldom necessary to call ZwFlushKey.
Callers of ZwFlushKey must be running at IRQL PASSIVE_LEVEL.
See Also