#include <nwmisc.h> or #include <nwcalls.h>NWCCODE N_API NWConvertFileHandle (NWFILE_HANDLE fileHandle, nuint16 handleType, pnuint8 NWHandle, NWCONN_HANDLE N_FAR
conn);
The handle returned by NWConvertFileHandle should not be used to call NWConvertHandle, otherwise a new OS file handle will be created.
If NWConvertFileHandle is called with only the shell (NETX) running, the connection handle will NOT be returned. Instead NWConvertFileHandle will return INVALID_CONNECTION. However, the NetWare handle will still be valid and conn will be set to zero.
If NULL is passed in conn, no error will be returned. If a pointer is passed in conn and the shell is running, a valid NetWare handle will be returned as well as 0x8801. .P On the Mac OS, the above remarks are not true. These are non-native file handles and can only be used with the NetWare functions.
When a connection handle is obtained, this creates a new, licensed connection handle that should be closed by NWCloseConn when no longer used.
File I/O