NWConvertHandle

Converts a NetWare handle to a local file handle

NetWare Server:3.11, 3.12, 3.2, 4.x, 5.x, 6.x

Platform:NLM, Windows NT, Windows 95, Windows 98

Library:Cross-Platform NetWare Calls (CAL*.*)

Service:File System

Syntax

   #include <nwmisc.h> 
   or 
   #include <nwcalls.h> 
    
   N_EXTERN_LIBRARY(NWCCODE) NWConvertHandle ( 
      NWCONN_HANDLE         conn,  
      nuint8                accessMode,  
      const void N_FAR     *NWHandle,  
      nuint16               handleSize,  
      nuint32               fileSize,  
      NWFILE_HANDLE N_FAR  *fileHandle);

Delphi Syntax

   uses calwin32 
    
   Function NWConvertHandle 
     (conn : NWCONN_HANDLE; 
      accessMode : nuint8; 
      const NWHandle : nptr; 
      handleSize : nuint16; 
      fileSize : nuint32; 
      Var fileHandle : NWFILE_HANDLE 
   ) : NWCCODE;

Parameters

conn: (IN) Specifies the connection where the NetWare handle exists to which the local file handle is being converted.
accessMode: (IN) Specifies the type of access the user will have to the newly created file handle.
NWHandle: (IN) Points to the 4- or 6-byte NetWare handle being converted to a local file handle.
handleSize: (IN) Specifies the number of bytes in the NetWare handle; either 4 or 6.
fileSize: (IN) Specifies the number of bytes in the file being converted.
fileHandle: (OUT) Points to the local file handle created by NWConvertHandle.

Return Values

These are common return values; see Return Values (Return Values for C)for more information.

0x0000

SUCCESSFUL

Remarks

The handle returned by the NWConvertFileHandle function should not be used to call NWConvertHandle. Otherwise, a new OS file handle will be created.

The file handle returned is appropriate for the platform for which the function is written. The file handle may be used for access to the attribute value including closing the file as well as reading and writing to the file.

See Section 20.1, Access Right Values for the possible values for the accessMode parameter.