NWRenameDirectory(3nw)


NWRenameDirectory -- renames NetWare directory

Synopsis

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

NWCCODE N_API NWRenameDirectory (NWCONN_HANDLE conn, NWDIR_HANDLE dirHandle, pnstr8 oldName, pnstr8 newName);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

dirHandle
(IN) Specifies the directory handle for the directory being deleted.

oldName
(IN) Points to the string containing the name of the directory to be renamed.

newName
(IN) Points to the string containing the new directory name.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8836
NWE_PARAM_INVALID

0x8980
FILE_IN_USE_ERROR

0x898B
NO_RENAME_PRIVILEGES

0x8992
NO_FILES_RENAMED_NAME_EXISTS

0x8996
SERVER_OUT_OF_MEMORY

0x8998
VOLUME_DOES_NOT_EXIST

0x899B
BAD_DIRECTORY_HANDLE

0x899C
INVALID_PATH

0x899E
INVALID_FILENAME

0x89A1
DIRECTORY_IO_ERROR

0x89FD
BAD_STATION_NUMBER

0x89FF
Failure

Notices

dirHandle can be zero if oldName points to the complete path, including the volume name.

newName should only include the new name of the directory without listing the volume or directory path. Otherwise, NWRenameDirectory will return NWE_PARAM_INVALID.

Services

File Systems

NCP calls

0x2222 22 15 Rename Directory
0x2222 23 17 Get File Server Information
0x2222 87 04 Rename Or Move A File Or Subdirectory
0x2222 87 22 Generate Directory Base and Volume Number

 
 ----------------------------------------- 
| 0x2222|  22|  15|  Rename Directory    | 
|-------|----|----|----------------------| 
| 0x2222|  23|  17|  Get File Server     | 
|       |    |    |  Information         | 
|-------|----|----|----------------------| 
| 0x2222|  87|  04|  Rename Or Move A    | 
|       |    |    |  File Or Subdirectory| 
|-------|----|----|----------------------| 
| 0x2222|  87|  22|  Generate Directory  | 
|       |    |    |  Base and Volume     | 
|       |    |    |  Number              | 
|-------|----|----|----------------------| 

References

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