FEQuickOpen

Performs a quick open on 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 FEQuickOpen  (  
      LONG   connection,   
      LONG   task,   
      LONG   volumeNumber,  
      LONG   directoryNumber,   
      BYTE  *pathString,   
      LONG   pathCount,  
      LONG   nameSpace,   
      LONG   attributeMatchBits,   
      LONG   requestedAccessRights,  
      LONG   dataStreamNumber,   
      LONG  *fileHandle); 
   

Parameters

connection

(IN) Specifies the connection opening the file.

task

(IN) Specifies the task number of the connection opening the file.

volumeNumber

(IN) Specifies the volume on which the file is located.

directoryNumber

(IN) Specifies the directory number of the file to be opened.

pathString

(IN) Points to the NetWare style path that, along with volumeNumber, directoryNumber, pathCount, and nameSpace, identifies the file to be opened.

pathCount

(IN) Specifies the number of components in pathString.

nameSpace

(IN) Specifies the name space in which the file resides (see Section 20.5, Name Space Flag Values).

attributeMatchBits

(IN) Specifies file attributes—open the file with file attributes that match this bit mask.

requestedAccessRights

(IN) Specifies the mode of entry for opening the file (for example, read only and read/write).

dataStreamNumber

(IN) Specifies the number identifying the data stream of the file to be opened.

fileHandle

(OUT) Points to the handle that designates the open file.

Return Values

See Return Values for C for more information.

0

Success

NetWare errors

Remarks

FEQuickOpen performs a quick open on a file specified by input parameters and returns a designating handle in fileHandle. FEQuickOpen is designated "quick" because it bypasses some of the higher I/O levels in the server libraries.

FEQuickOpen is useful only in conjunction with the File System Monitoring Hooks functions. The handle returned is useful only for other FEQuick .. . functions.

See Also

FEQuickClose, FEQuickFileLength, FEQuickRead, FEQuickWrite NWAddFSMonitorHook, NWRemoveFSMonitorHook