Reference

NtCreateFile(3w)

NAME

NtCreateFile (NTDLL.@)

SYNOPSIS

NTSTATUS NtCreateFile
(
PHANDLE handle,
ACCESS_MASK access,
POBJECT_ATTRIBUTES attr,
PIO_STATUS_BLOCK io,
PLARGE_INTEGER alloc_size,
ULONG attributes,
ULONG sharing,
ULONG disposition,
ULONG options,
PVOID ea_buffer,
ULONG ea_length
)

DESCRIPTION

Either create a new file or directory, or open an existing file, device, directory or volume.

PARAMS

handle [Out] Points to a variable which receives the file handle on return.

access [In] Desired access to the file.

attr [In] Structure describing the file.

io [Out] Receives information about the operation on return.

alloc_size [In] Initial size of the file in bytes.

attributes [In] Attributes to create the file with.

sharing [In] Type of shared access the caller would like to the file.

disposition [In] Specifies what to do, depending on whether the file already exists.

options [In] Options for creating a new file.

ea_buffer [In] Pointer to an extended attributes buffer.

ea_length [In] Length of ea_buffer.

RETURNS

Success: 0. handle and io are updated.

Failure: An NTSTATUS error code describing the error.

IMPLEMENTATION

Declared in "winternl.h".

Implemented in "dlls/ntdll/file.c".

Debug channel "ntdll".

History