[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
FN_RENDIR()
Rename directory
------------------------------------------------------------------------------
Syntax
fn_RenDir( <nHandle>, <cPath>, <cNewName> ) --> <nStatus>
Arguments
<nHandle> is a handle to a directory path, usually obtained with
fn_alTemDH().
<cPath> is the desired pathspec. If the pathspec is fully defined
by the handle, then pass an empty string or NIL.
<cNewName> is the new directory name. Note that it is the name only,
not the entire pathspec.
Returns
<nStatus> will be zero if the directory was deleted. If an error
occurred then <nStatus> will contain a NetWare error code;
likely possibilities are NO_RENAME_PRIVILEGES,
BAD_DIRECTORY_HANDLE, or INVALID_PATH.
Description
This call allows the developer to change the name of a directory, given
the directory handle/path specification and the new name of the
directory. Rename privileges must be in effect and the new directory
name cannot already exist.
Examples
// Rename a directory on the SYS volume
fn_RenDir( 0, "SYS:\THISDIR\THATDIR", "YOURDIR" )
// Rename a directory on the VOL1 volume using a handle
aDHInfo := fn_alTemDH( 0, "Z", "VOL1:\THISDIR" )
fn_RenDir( aDHInfo[ 1 ], "THATDIR", "YOURDIR" )
Header File: netto.CH (only needed if you want to make use of the #defines for
Header File: the error codes).
Source: N:\SRC\FSYS\RENDIR.PRG
Author: Ted Means
See Also:
fn_MkDir()
fn_GetCD()
fn_RmDir()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson