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".