[<<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