_NWConvertHandle(3nw)


_NWConvertHandle -- converts NetWare handle to client platform handle

Synopsis

   #include <nwmisc.h> 
   #include <nwnamspc.h> 
   or 
   #include <nwcalls.h> 
   

NWCCODE N_API _NWConvertHandle (NWCONN_HANDLE conn, nuint8 accessMode, pnuint8 NWHandle, nuint32 fileSize, NW_FILE_HANDLE N_FAR * fileHandle);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

accessMode
(IN) Specifies the access mode of the file.

NWHandle
(IN) Points to the NetWare handle to be converted.

fileSize
(IN) Specifies the size of the file.

fileHandle
(OUT) Points to the file handle returned.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x88A0
MEMORY_ALLOCATION_ERROR

Notices

At least AR_READ and/or AR_WRITE must be used in accessMode. If neither of these are used, _NWConvertHandle sets both.

On the Mac OS, which does not create OS file handles, a new NWFILE_HANDLE would be created.

The following are the access mode definitions:

0x0001
AR_READ

0x0002
AR_WRITE

0x0004
AR_DENY_READ

0x0008
AR_DENY_WRITE

0x0010
AR_COMPATIBILITY

0x0040
AR_WRITE_THROUGH

0x0100
AR_OPEN_COMPRESSED

Services

Miscellaneous

NCP calls

None
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.