_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.