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.