NtCreateFile.3w

Langue: en

Version: Jun 2009 (debian - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

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

Defined in "winternl.h".

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

Debug channel "ntdll".