BUG: Registry Access from Multiple Threads Might Fail

• Microsoft Win32 Application Programming Interface (API), used with:
  • Microsoft Windows NT 4.0
  • Microsoft Windows 2000

SYMPTOMS

If you simultaneously access the same registry key from multiple threads in a single process, an error might occur. For example, if several threads in a carefully designed multi-threaded Win32 application try to open the same registry key using RegOpenKeyEx()in a loop, the function could fail with the following error code of 6:

ERROR_INVALID_HANDLE

CAUSE

This behavior is intermittent and is the result of a race condition between the threads simultaneously accessing the same registry key.

RESOLUTION

There are several possible workarounds for this situation:

1. Do not access the same registry location from multiple threads in a single process.



2. Synchronize access to the registry location. You can do this by serializing access to the code that accesses the registry with a critical section or other Win32 synchronization mechanisms.



3. When this error occurs, Sleep() a short time and try to access the registry key again. It is a race condition that causes this problem, so this workaround is not guaranteed to work. It is possible that the registry key is indeed invalid. However, this is the easiest solution to work into an existing application.

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 code illustrates the problem with the RegOpenKeyEx() function. Note that the error only happens intermittently with the following code.

Sample Code

   #include <windows.h>
   #include <winbase.h>
   #include <stdio.h>

   #define ITERATIONS 1000
   VOID ThreadFunc(LPVOID);

   void main(void)
   {
    int numThreads=100;
    DWORD threadID;
    int i;

     for (i=0; i<numThreads; i++)
     {
       CreateThread(0, 0,(LPTHREAD_START_ROUTINE) ThreadFunc,
                    0, 0, &threadID);
     }
     return;
   }

   VOID ThreadFunc(LPVOID)
   {
     LONG rc;
     HKEY hKey;

     for(int i=0; i < ITERATIONS; i++)
     {
       rc = RegOpenKeyEx( HKEY_LOCAL_MACHINE, "SOFTWARE\\Microsoft",
                          0, KEY_ALL_ACCESS, &hKey);

       if (rc != ERROR_SUCCESS)
         printf("Iteration(%d): Thread Id: %d, Error=%d\r\n", i,
                                   GetCurrentThreadId(), rc);
       else
          rc = RegCloseKey(hKey);
     }
   } 

Additional query words: regedit problem known occasionally concurrently RegOpenKey RegCloseKey

Keywords : kberrmsg kbAPI kbKernBase kbNTOS400 kbWinOS2000 kbRegistry kbDSupport kbGrpKernBase
Version : winnt:4.0
Platform : winnt
Issue type : kbbug