NWOpenCreateNSEntry(3nw)


NWOpenCreateNSEntry -- opens a file in the specified name space or creates and then opens a file if it does not already exist

Synopsis

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

NWCCODE N_API NWOpenCreateNSEntry (NWCONN_HANDLE conn, NWDIR_HANDLE dirHandle, nuint8 namSpace, pnstr8 path, NW_NS_OPENCREATE N_FAR * NSOpenCreate, NWFILE_HANDLE N_FAR * fileHandle);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare connection handle.

dirHandle
(IN) Specifies the directory handle on which to open/create specified file.

namSpace
(IN) Specifies the name space of dirHandle/path.

path
(IN) Points to an absolute path, (or relative if dirHandle is nonzero).

NSOpenCreate
(IN/OUT) Points to NW_NS_OPEN containing information needed to create the entry on input. Points to NW_NS_OPEN containing the results of a successful open/create upon output

fileHandle
(OUT) Points to the NWFILE_HANDLE. When you are creating subdirectories, fileHandle returns zero.

Return values

0x0000
SUCCESSFUL

0x8980
ERR_LOCK_FAIL

0x8981
NO_MORE_FILE_HANDLES

0x8982
NO_OPEN_PRIVILEGES

0x8994
NO_WRITE_PRIVILEGES_OR_READONLY

0x8996
SERVER_OUT_OF_MEMORY

0x8998
SERVER_DOES_NOT_EXIST

0x899C
INVALID_PATH

0x89A1
DIRECTORY_IO_ERROR

0x89FD
BAD_STATION_NUMBER

0x89FF
Failure

Services

Name Space

NCP calls

0x2222 23 17
Get File Server Info

0x2222 66
File Close

0x2222 87 1
Open/Create Entry

0x2222 87 30
Open/Create File or Subdirectory

References

NWDeleteNSEntry(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.