Microsoft KB Archive/60028

= The rename function may fail when you use the rename function to change a directory name that is the current working directory =

Article ID: 60028

Article Last Modified on 4/24/2006

-

APPLIES TO

 The C Run-Time (CRT), when used with:  Microsoft Visual C++ 1.0 Professional Edition

 Microsoft Visual C++ 1.5 Professional Edition

 Microsoft Visual C++ 1.0 Professional Edition

 Microsoft Visual C++ 2.0 Professional Edition</li></ul>

 Microsoft Visual C++ 4.0 Standard Edition</li></ul>

 Microsoft Visual C++ 5.0 Standard Edition</li></ul>

 Microsoft Visual C++ 6.0 Service Pack 5</li></ul> </li></ul>

-

<div class="notice_section">

This article was previously published under Q60028

<div class="notice_section">

<div class="symptoms_section">

SYMPTOMS
Using the rename function to change a subdirectory name may fail if the directory name you want to change is the current working directory for that drive. In addition, some versions of MS-DOS may return a success value, but the directory name apparently has not changed.

<div class="cause_section">

CAUSE
An access violation occurs attempting to rename the current directory.

<div class="resolution_section">

RESOLUTION
To work around this problem, use the chdir function to set the current directory of the specified drive to be the root directory on the drive. However, in Windows NT, this procedure does not guarantee success because an error occurs if another process uses the target directory.

You can optimize this method by checking the active directory on the target drive. Change directories only if the directory to rename is the current directory.

<div class="moreinformation_section">

MORE INFORMATION
In MS-DOS versions 3.x when SHARE.EXE is not installed, the sample program shown below produces the following results: <pre class="fixed_text">  C:\>cd olddir C:\OLDDIR>d: D:>test Rename is successful <--- Output from test program D:>c: C:\OLDDIR>     <--- The old directory is not renamed In MS-DOS version 3.3 when SHARE.EXE is installed, in MS-DOS versions 4.x and later, in an MS-DOS window in OS/2, or in an MS-DOS window in Windows NT, the sample program produces the following results: <pre class="fixed_text">  C:\>cd olddir C:\OLDDIR>d: D:>test Rename fails with errno = 13 <--- Output from test program D:>c: C:\OLDDIR>           <--- The old directory is not renamed Note errno code 13 indicates an access violation.

This behavior does not indicate a problem with the rename function. It simply maps to an Interrupt 21h, Function 56h (Rename File) call in MS-DOS. The problem occurs because the operating system maintains a list of the current working directory (CWD) for each drive in its drive table in memory.

In the MS-DOS 3.x example, the program successfully changed the directory name. However, because MS-DOS does not recognize the change, it does not update the CWD in the drive table. When the program ends, MS-DOS displays an invalid prompt that reflects the old directory name. If you type &quot;CD \NEWDIR&quot; at the MS-DOS prompt, the drive table is updated.

In the second example, MS-DOS 3.3 with SHARE.EXE installed, MS-DOS versions 4.x and later, and MS-DOS running in OS/2 cannot determine if another process is using the directory and an access violation error occurs.

On Windows NT and Windows 2000, if any process is active in the target directory, the system does not change the directory name. When this happens, the function returns an error code 13 that indicates an access violation. On Windows Millennium Edition (Me), the function succeeds.

Sample code

 * 1) include <stdlib.h>
 * 2) include <stdio.h>

char szOldName[] = &quot;c:\\olddir&quot;; char szNewName[] = &quot;c:\\newdir&quot;;

extern int errno;

void main (void) {  if (0 != rename(szOldName, szNewName)) printf(&quot;Rename fails with errno = %d\n&quot;, errno); else printf(&quot;Rename is successful\n&quot;); }

Keywords: kbtshoot kbprb kbcode KB60028

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.