Opens a file in the specified name space or creates and then opens a file if it does not already exist. Path and file names must use UTF-8 characters.
#include <nwnamspc.h>
or
#include <nwcalls.h>
NWCCODE N_API NWOpenCreateNSEntryExt (
NWCONN_HANDLE conn,
nuint8 dirHandle,
nuint8 namSpc,
const pnstr8 N_FAR path,
NW_NS_OPENCREATE N_FAR *NSOpenCreate,
NWFILE_HANDLE N_FAR *fileHandle);
(IN) Specifies the NetWare connection handle.
(IN) Specifies the directory handle on which to open/create the specified file.
(IN) Specifies the name space of dirHandle/path (see Section 20.5, Name Space Flag Values).
(IN) Points to an absolute path (or relative if dirHandle is nonzero). The characters in the path string must be UTF-8.
(IN/OUT) Points to NW_NS_OPENCREATE containing information needed to create the entry on input. Points to NW_NS_OPENCREATE containing the results of a successful open/create upon output.
(OUT) Points to the NWFILE_HANDLE. When you are creating subdirectories, fileHandle returns zero.
These are common return values; see Return Values (Return Values for C) for more information.