NtReadFile(3w)

Usage

NTSTATUS NtReadFile
(
HANDLE hFile,
HANDLE hEvent,
PIO_APC_ROUTINE apc,
void* apc_user,
PIO_STATUS_BLOCK io_status,
void* buffer,
ULONG length,
PLARGE_INTEGER offset,
PULONG key
)

Overview

Read from an open file handle.

Params

FileHandle [In] Handle returned from ZwOpenFile(3w) or ZwCreateFile(3w).

Event [In] Event to signal upon completion (or NULL).

ApcRoutine [In] Callback to call upon completion (or NULL).

ApcContext [In] Context for ApcRoutine (or NULL).

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

Buffer [Out] Destination for the data read.

Length [In] Size of Buffer.

ByteOffset [Out] Destination for the new file pointer position (or NULL).

Key [Out] Function unknown (may be NULL).

Returns

Success: 0. IoStatusBlock is updated, and the Information member contains The number of bytes read.

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.