BUG: _stat Function Fails for Names Ending with "\"

• The C Run-time (CRT) included with: - Microsoft Visual C++, 32-bit Editions, version 5.0

SYMPTOMS

Using the C-Run-time function stat to check a directory fails when the name passed to the function ends with "\".

For example, _stat("\\my_directory\\my_name",&buf) returns OK, but _stat("\\my_directory\\my_name\\",&buf) will return -1 as error.

CAUSE

The _stat function calls the windows API function FindFirstFile passing it the path name. The FindFirstFile returns an invalid handle if the name ends with "\."

RESOLUTION

Remove the trailing "\" from the path name.

STATUS

Microsoft has confirmed this to be a bug in the Microsoft products listed at the beginning of this article. We are researching this bug and will post new information here in the Microsoft Knowledge Base as it becomes available.

MORE INFORMATION

The following Sample program demonstrates the problem:

   //Sample.cpp
   /* Compiler Options : none */
   #include <sys/types.h>
   #include <sys/stat.h>
   #include <stdio.h>
   #include <windows.h>
     HANDLE            hSearch;
     WIN32_FIND_DATA   Buf;
   int main( void )
   {
      struct _stat buf;
      int result;

      result = _stat( "c:\\temp", &buf );
      if( result != 0 )
         printf( "_stat function on c:\\temp failed " );

      result = _stat( "c:\\temp\\", &buf );
      if( result != 0 )
        printf( "_stat function on c:\\temp\\ failed " );

      hSearch= FindFirstFile((LPSTR)"c:\\temp", &Buf);
      if (hSearch == INVALID_HANDLE_VALUE )
         printf("\n\n FindFirstFile on c:\\temp failed too");

      hSearch= FindFirstFile((LPSTR)"c:\\temp\\", &Buf);
      if (hSearch == INVALID_HANDLE_VALUE )
         printf("\n\n FindFirstFile on c:\\temp\\ failed too");

   return 0;
   }

If you have a valid C:\temp directory:

_stat function on c:\temp\ failed.

 FindFirstFile on c:\temp\ failed, too.

REFERENCES

Online docs on _stat CRT function mk:@ivt:vccore/F3F/F43/D4D/S4CF6A.HTM