NtCreateFile(3w)

Usage

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
)

Overview

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

Releases

4 releases since Debian 4.0 (Etch); the text changed 3 times.