FSCTL_MARK_AS_SYSTEM_HIVE control code

The FSCTL_MARK_AS_SYSTEM_HIVE control code informs the file system that the specified file contains the registry's system hive. The file system must flush system hive data to disk at just the right moment to avoid deadlocks and to ensure data integrity. Do not use this file system control code with any file other than the file that contains the registry's system hive. This control code does not work with a directory or volume handle. File system redirectors that access files on remote machines treat this control code as a no-op.

Only kernel-level components can use this filesystem control code.

To perform this operation, call FltFsControlFile or ZwFsControlFile with the following parameters.

Parameters

FileObject

FltFsControlFile only. File object pointer for the user file. This parameter is required and cannot be NULL.

FileHandle

ZwFsControlFile only. Handle for the user file. This parameter is required and cannot be NULL.

FsControlCode

The control code for the operation. Use FSCTL_MARK_AS_SYSTEM_HIVE for this operation.

InputBuffer

Not used. Assign a value of NULL to this parameter.

InputBufferLength

Not used.

OutputBuffer

Not used. Assign a value of NULL to this parameter.

OutputBufferLength

Not used.

Return Value

FltFsControlFile or ZwFsControlFile returns STATUS_SUCCESS if the operation succeeds. Otherwise, the appropriate function returns the appropriate NTSTATUS error code.

Requirements

Header

Ntifs.h (include Ntifs.h)

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft. All rights reserved.