NWConvertHandle(3nw)
NWConvertHandle --
converts a NetWare handle to a local file handle
Synopsis
#include <nwmisc.h>
or
#include <nwcalls.h>
NWCCODE N_API NWConvertHandle
(NWCONN_HANDLE conn,
nuint8 accessMode,
nptr NWHandle,
nuint16 handleSize,
nuint32 fileSize,
NWFILE_HANDLE N_FAR
fileHandle);
Description
The parameters are as follows:
- conn
-
(IN) Specifies the connection where the NetWare handle the local file handle is being converted to exists.
- 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 coverted 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
- 0x0000
-
SUCCESSFUL
Notices
The handle returned by NWConvertFileHandle 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 the API is written for. This file handle may be used for access to the attribute value through standard file I/O with the
handle. This includes closing the file as well as reading and writing to the file.
For Windows, call _lread, _lwrite, _lclose, and _llseek rather than calling the standard file I/O functions. Calling standard file I/O
functions in Windows returns unexpected results.
Services
File I/O
NCP calls
None
References
NWConvertFileHandle(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.