FEQuickRead

Performs a quick read of data in a file on the local server

Local Servers:blocking
Remote Servers:N/A
NetWare Server:3.x, 4.x, 5.x, 6.x
Platform:NLM
Service:File Engine

Syntax

   #include <nwfileng.h>  
    
   int FEQuickRead  (  
      LONG   connection,   
      LONG   handle,   
      LONG   position,  
      LONG   bytesToRead,   
      LONG  *bytesRead,   
      void  *buffer); 
   

Parameters

connection

(IN) Specifies the connection reading the data.

handle

(IN) Specifies the handle of the file from which the data is being read.

position

(IN) Specifies the location in the file at which to start reading.

bytesToRead

(IN) Specifies the number of bytes to read.

bytesRead

(OUT) Points to number of bytes actually read.

buffer

(OUT) Points to the buffer into which the read data is stored.

Return Values

See Return Values for C for more information.

0

Success

NetWare errors

Remarks

FEQuickRead is designated "quick" because it bypasses some of the higher I/O levels in the server libraries.

FEQuickRead is useful only in conjunction with the File System Monitoring Hooks functions and other FEQuick functions. The lower level handle used with FEQuickRead is returned in FEQuickOpen and is not valid for more conventional functions like read, write, or close.

When FEQuickRead is successful (returns 0), the number of bytes actually read is located in the bytesRead parameter.

NOTE:It is the responsibility of the caller to keep track of and maintain the position parameter.

See Also

FEQuickClose, FEQuickFileLength, FEQuickOpen, FEQuickWrite, NWAddFSMonitorHook, NWRemoveFSMonitorHook