git.oblomov.eu Git - wine/blob - dlls/advapi32/registry.c

   1 /*
   2  * Registry management
   3  *
   4  * Copyright (C) 1999 Alexandre Julliard
   5  *
   6  * Based on misc/registry.c code
   7  * Copyright (C) 1996 Marcus Meissner
   8  * Copyright (C) 1998 Matthew Becker
   9  * Copyright (C) 1999 Sylvain St-Germain
  10  *
  11  * This library is free software; you can redistribute it and/or
  12  * modify it under the terms of the GNU Lesser General Public
  13  * License as published by the Free Software Foundation; either
  14  * version 2.1 of the License, or (at your option) any later version.
  15  *
  16  * This library is distributed in the hope that it will be useful,
  17  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  19  * Lesser General Public License for more details.
  20  *
  21  * You should have received a copy of the GNU Lesser General Public
  22  * License along with this library; if not, write to the Free Software
  23  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  24  */
  25
  26 #include <stdlib.h>
  27 #include <stdarg.h>
  28 #include <stdio.h>
  29
  30 #include "ntstatus.h"
  31 #define WIN32_NO_STATUS
  32 #include "windef.h"
  33 #include "winbase.h"
  34 #include "winreg.h"
  35 #include "winerror.h"
  36 #include "winternl.h"
  37 #include "winuser.h"
  38
  39 #include "wine/unicode.h"
  40 #include "wine/debug.h"
  41
  42 WINE_DEFAULT_DEBUG_CHANNEL(reg);
  43
  44 #define HKEY_SPECIAL_ROOT_FIRST   HKEY_CLASSES_ROOT
  45 #define HKEY_SPECIAL_ROOT_LAST    HKEY_DYN_DATA
  46
  47 static const WCHAR name_CLASSES_ROOT[] =
  48     {'M','a','c','h','i','n','e','\\',
  49      'S','o','f','t','w','a','r','e','\\',
  50      'C','l','a','s','s','e','s',0};
  51 static const WCHAR name_LOCAL_MACHINE[] =
  52     {'M','a','c','h','i','n','e',0};
  53 static const WCHAR name_USERS[] =
  54     {'U','s','e','r',0};
  55 static const WCHAR name_PERFORMANCE_DATA[] =
  56     {'P','e','r','f','D','a','t','a',0};
  57 static const WCHAR name_CURRENT_CONFIG[] =
  58     {'M','a','c','h','i','n','e','\\',
  59      'S','y','s','t','e','m','\\',
  60      'C','u','r','r','e','n','t','C','o','n','t','r','o','l','S','e','t','\\',
  61      'H','a','r','d','w','a','r','e',' ','P','r','o','f','i','l','e','s','\\',
  62      'C','u','r','r','e','n','t',0};
  63 static const WCHAR name_DYN_DATA[] =
  64     {'D','y','n','D','a','t','a',0};
  65
  66 static const WCHAR * const root_key_names[] =
  67 {
  68     name_CLASSES_ROOT,
  69     NULL,         /* HKEY_CURRENT_USER is determined dynamically */
  70     name_LOCAL_MACHINE,
  71     name_USERS,
  72     name_PERFORMANCE_DATA,
  73     name_CURRENT_CONFIG,
  74     name_DYN_DATA
  75 };
  76
  77 #define NB_SPECIAL_ROOT_KEYS   (sizeof(root_key_names)/sizeof(root_key_names[0]))
  78
  79 static HKEY special_root_keys[NB_SPECIAL_ROOT_KEYS];
  80 static BOOL hkcu_cache_disabled;
  81
  82 static const int is_win64 = (sizeof(void *) > sizeof(int));
  83
  84 /* check if value type needs string conversion (Ansi<->Unicode) */
  85 static inline int is_string( DWORD type )
  86 {
  87     return (type == REG_SZ) || (type == REG_EXPAND_SZ) || (type == REG_MULTI_SZ);
  88 }
  89
  90 /* check if current version is NT or Win95 */
  91 static inline int is_version_nt(void)
  92 {
  93     return !(GetVersion() & 0x80000000);
  94 }
  95
  96 static BOOL is_wow6432node( const UNICODE_STRING *name )
  97 {
  98     static const WCHAR wow6432nodeW[] = {'W','o','w','6','4','3','2','N','o','d','e'};
  99
 100     return (name->Length == sizeof(wow6432nodeW) &&
 101             !memicmpW( name->Buffer, wow6432nodeW, sizeof(wow6432nodeW)/sizeof(WCHAR) ));
 102 }
 103
 104 /* open the Wow6432Node subkey of the specified key */
 105 static HANDLE open_wow6432node( HANDLE key, const UNICODE_STRING *name )
 106 {
 107     static const WCHAR wow6432nodeW[] = {'W','o','w','6','4','3','2','N','o','d','e',0};
 108     OBJECT_ATTRIBUTES attr;
 109     UNICODE_STRING nameW;
 110     HANDLE ret;
 111
 112     attr.Length = sizeof(attr);
 113     attr.RootDirectory = key;
 114     attr.ObjectName = &nameW;
 115     attr.Attributes = 0;
 116     attr.SecurityDescriptor = NULL;
 117     attr.SecurityQualityOfService = NULL;
 118     RtlInitUnicodeString( &nameW, wow6432nodeW );
 119     if (NtOpenKey( &ret, MAXIMUM_ALLOWED, &attr )) ret = 0;
 120     return ret;
 121 }
 122
 123 /* wrapper for NtCreateKey that creates the key recursively if necessary */
 124 static NTSTATUS create_key( HKEY *retkey, ACCESS_MASK access, OBJECT_ATTRIBUTES *attr,
 125                             const UNICODE_STRING *class, ULONG options, PULONG dispos )
 126 {
 127     BOOL force_wow32 = is_win64 && (access & KEY_WOW64_32KEY);
 128     NTSTATUS status = STATUS_OBJECT_NAME_NOT_FOUND;
 129
 130     if (!force_wow32) status = NtCreateKey( (HANDLE *)retkey, access, attr, 0, class, options, dispos );
 131
 132     if (status == STATUS_OBJECT_NAME_NOT_FOUND)
 133     {
 134         HANDLE subkey, root = attr->RootDirectory;
 135         WCHAR *buffer = attr->ObjectName->Buffer;
 136         DWORD attrs, pos = 0, i = 0, len = attr->ObjectName->Length / sizeof(WCHAR);
 137         UNICODE_STRING str;
 138
 139         while (i < len && buffer[i] != '\\') i++;
 140         if (i == len && !force_wow32) return status;
 141
 142         attrs = attr->Attributes;
 143         attr->Attributes &= ~OBJ_OPENLINK;
 144         attr->ObjectName = &str;
 145
 146         while (i < len)
 147         {
 148             str.Buffer = buffer + pos;
 149             str.Length = (i - pos) * sizeof(WCHAR);
 150             if (force_wow32 && pos)
 151             {
 152                 if (is_wow6432node( &str )) force_wow32 = FALSE;
 153                 else if ((subkey = open_wow6432node( attr->RootDirectory, &str )))
 154                 {
 155                     if (attr->RootDirectory != root) NtClose( attr->RootDirectory );
 156                     attr->RootDirectory = subkey;
 157                     force_wow32 = FALSE;
 158                 }
 159             }
 160             status = NtCreateKey( &subkey, access, attr, 0, class,
 161                                   options & ~REG_OPTION_CREATE_LINK, dispos );
 162             if (attr->RootDirectory != root) NtClose( attr->RootDirectory );
 163             if (status) return status;
 164             attr->RootDirectory = subkey;
 165             while (i < len && buffer[i] == '\\') i++;
 166             pos = i;
 167             while (i < len && buffer[i] != '\\') i++;
 168         }
 169         str.Buffer = buffer + pos;
 170         str.Length = (i - pos) * sizeof(WCHAR);
 171         attr->Attributes = attrs;
 172         status = NtCreateKey( (PHANDLE)retkey, access, attr, 0, class, options, dispos );
 173         if (attr->RootDirectory != root) NtClose( attr->RootDirectory );
 174     }
 175     return status;
 176 }
 177
 178 /* wrapper for NtOpenKey to handle Wow6432 nodes */
 179 static NTSTATUS open_key( HKEY *retkey, ACCESS_MASK access, OBJECT_ATTRIBUTES *attr )
 180 {
 181     NTSTATUS status;
 182     BOOL force_wow32 = is_win64 && (access & KEY_WOW64_32KEY);
 183     HANDLE subkey, root = attr->RootDirectory;
 184     WCHAR *buffer = attr->ObjectName->Buffer;
 185     DWORD attrs, pos = 0, i = 0, len = attr->ObjectName->Length / sizeof(WCHAR);
 186     UNICODE_STRING str;
 187
 188     if (!force_wow32) return NtOpenKey( (HANDLE *)retkey, access, attr );
 189
 190     if (len && buffer[0] == '\\') return STATUS_OBJECT_PATH_INVALID;
 191     while (i < len && buffer[i] != '\\') i++;
 192     attrs = attr->Attributes;
 193     attr->Attributes &= ~OBJ_OPENLINK;
 194     attr->ObjectName = &str;
 195
 196     while (i < len)
 197     {
 198         str.Buffer = buffer + pos;
 199         str.Length = (i - pos) * sizeof(WCHAR);
 200         if (force_wow32 && pos)
 201         {
 202             if (is_wow6432node( &str )) force_wow32 = FALSE;
 203             else if ((subkey = open_wow6432node( attr->RootDirectory, &str )))
 204             {
 205                 if (attr->RootDirectory != root) NtClose( attr->RootDirectory );
 206                 attr->RootDirectory = subkey;
 207                 force_wow32 = FALSE;
 208             }
 209         }
 210         status = NtOpenKey( &subkey, access, attr );
 211         if (attr->RootDirectory != root) NtClose( attr->RootDirectory );
 212         if (status) return status;
 213         attr->RootDirectory = subkey;
 214         while (i < len && buffer[i] == '\\') i++;
 215         pos = i;
 216         while (i < len && buffer[i] != '\\') i++;
 217     }
 218     str.Buffer = buffer + pos;
 219     str.Length = (i - pos) * sizeof(WCHAR);
 220     attr->Attributes = attrs;
 221     status = NtOpenKey( (PHANDLE)retkey, access, attr );
 222     if (attr->RootDirectory != root) NtClose( attr->RootDirectory );
 223     return status;
 224
 225 }
 226
 227 /* create one of the HKEY_* special root keys */
 228 static HKEY create_special_root_hkey( HKEY hkey, DWORD access )
 229 {
 230     HKEY ret = 0;
 231     int idx = HandleToUlong(hkey) - HandleToUlong(HKEY_SPECIAL_ROOT_FIRST);
 232
 233     if (HandleToUlong(hkey) == HandleToUlong(HKEY_CURRENT_USER))
 234     {
 235         if (RtlOpenCurrentUser( access, (HANDLE *)&hkey )) return 0;
 236         TRACE( "HKEY_CURRENT_USER -> %p\n", hkey );
 237
 238         /* don't cache the key in the table if caching is disabled */
 239         if (hkcu_cache_disabled)
 240             return hkey;
 241     }
 242     else
 243     {
 244         OBJECT_ATTRIBUTES attr;
 245         UNICODE_STRING name;
 246
 247         attr.Length = sizeof(attr);
 248         attr.RootDirectory = 0;
 249         attr.ObjectName = &name;
 250         attr.Attributes = 0;
 251         attr.SecurityDescriptor = NULL;
 252         attr.SecurityQualityOfService = NULL;
 253         RtlInitUnicodeString( &name, root_key_names[idx] );
 254         if (create_key( &hkey, access, &attr, NULL, 0, NULL )) return 0;
 255         TRACE( "%s -> %p\n", debugstr_w(attr.ObjectName->Buffer), hkey );
 256     }
 257
 258     if (!(ret = InterlockedCompareExchangePointer( (void **)&special_root_keys[idx], hkey, 0 )))
 259         ret = hkey;
 260     else
 261         NtClose( hkey );  /* somebody beat us to it */
 262     return ret;
 263 }
 264
 265 /* map the hkey from special root to normal key if necessary */
 266 static inline HKEY get_special_root_hkey( HKEY hkey )
 267 {
 268     HKEY ret = hkey;
 269
 270     if ((HandleToUlong(hkey) >= HandleToUlong(HKEY_SPECIAL_ROOT_FIRST))
 271             && (HandleToUlong(hkey) <= HandleToUlong(HKEY_SPECIAL_ROOT_LAST)))
 272     {
 273         if (!(ret = special_root_keys[HandleToUlong(hkey) - HandleToUlong(HKEY_SPECIAL_ROOT_FIRST)]))
 274             ret = create_special_root_hkey( hkey, MAXIMUM_ALLOWED );
 275     }
 276     return ret;
 277 }
 278
 279
 280 /******************************************************************************
 281  * RegOverridePredefKey   [ADVAPI32.@]
 282  */
 283 LSTATUS WINAPI RegOverridePredefKey( HKEY hkey, HKEY override )
 284 {
 285     HKEY old_key;
 286     int idx;
 287
 288     TRACE("(%p %p)\n", hkey, override);
 289
 290     if ((HandleToUlong(hkey) < HandleToUlong(HKEY_SPECIAL_ROOT_FIRST))
 291             || (HandleToUlong(hkey) > HandleToUlong(HKEY_SPECIAL_ROOT_LAST)))
 292         return ERROR_INVALID_PARAMETER;
 293     idx = HandleToUlong(hkey) - HandleToUlong(HKEY_SPECIAL_ROOT_FIRST);
 294
 295     if (override)
 296     {
 297         NTSTATUS status = NtDuplicateObject( GetCurrentProcess(), override,
 298                                              GetCurrentProcess(), (HANDLE *)&override,
 299                                              0, 0, DUPLICATE_SAME_ACCESS );
 300         if (status) return RtlNtStatusToDosError( status );
 301     }
 302
 303     old_key = InterlockedExchangePointer( (void **)&special_root_keys[idx], override );
 304     if (old_key) NtClose( old_key );
 305     return ERROR_SUCCESS;
 306 }
 307
 308
 309 /******************************************************************************
 310  * RegCreateKeyExW   [ADVAPI32.@]
 311  *
 312  * See RegCreateKeyExA.
 313  */
 314 LSTATUS WINAPI RegCreateKeyExW( HKEY hkey, LPCWSTR name, DWORD reserved, LPWSTR class,
 315                              DWORD options, REGSAM access, SECURITY_ATTRIBUTES *sa,
 316                              PHKEY retkey, LPDWORD dispos )
 317 {
 318     OBJECT_ATTRIBUTES attr;
 319     UNICODE_STRING nameW, classW;
 320
 321     if (reserved) return ERROR_INVALID_PARAMETER;
 322     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
 323
 324     attr.Length = sizeof(attr);
 325     attr.RootDirectory = hkey;
 326     attr.ObjectName = &nameW;
 327     attr.Attributes = 0;
 328     attr.SecurityDescriptor = NULL;
 329     attr.SecurityQualityOfService = NULL;
 330     if (options & REG_OPTION_OPEN_LINK) attr.Attributes |= OBJ_OPENLINK;
 331     RtlInitUnicodeString( &nameW, name );
 332     RtlInitUnicodeString( &classW, class );
 333
 334     return RtlNtStatusToDosError( create_key( retkey, access, &attr, &classW, options, dispos ) );
 335 }
 336
 337
 338 /******************************************************************************
 339  * RegCreateKeyExA   [ADVAPI32.@]
 340  *
 341  * Open a registry key, creating it if it doesn't exist.
 342  *
 343  * PARAMS
 344  *  hkey       [I] Handle of the parent registry key
 345  *  name       [I] Name of the new key to open or create
 346  *  reserved   [I] Reserved, pass 0
 347  *  class      [I] The object type of the new key
 348  *  options    [I] Flags controlling the key creation (REG_OPTION_* flags from "winnt.h")
 349  *  access     [I] Access level desired
 350  *  sa         [I] Security attributes for the key
 351  *  retkey     [O] Destination for the resulting handle
 352  *  dispos     [O] Receives REG_CREATED_NEW_KEY or REG_OPENED_EXISTING_KEY
 353  *
 354  * RETURNS
 355  *  Success: ERROR_SUCCESS.
 356  *  Failure: A standard Win32 error code. retkey remains untouched.
 357  *
 358  * FIXME
 359  *  MAXIMUM_ALLOWED in access mask not supported by server
 360  */
 361 LSTATUS WINAPI RegCreateKeyExA( HKEY hkey, LPCSTR name, DWORD reserved, LPSTR class,
 362                              DWORD options, REGSAM access, SECURITY_ATTRIBUTES *sa,
 363                              PHKEY retkey, LPDWORD dispos )
 364 {
 365     OBJECT_ATTRIBUTES attr;
 366     UNICODE_STRING classW;
 367     ANSI_STRING nameA, classA;
 368     NTSTATUS status;
 369
 370     if (reserved) return ERROR_INVALID_PARAMETER;
 371     if (!is_version_nt())
 372     {
 373         access = MAXIMUM_ALLOWED;  /* Win95 ignores the access mask */
 374         if (name && *name == '\\') name++; /* win9x,ME ignores one (and only one) beginning backslash */
 375     }
 376     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
 377
 378     attr.Length = sizeof(attr);
 379     attr.RootDirectory = hkey;
 380     attr.ObjectName = &NtCurrentTeb()->StaticUnicodeString;
 381     attr.Attributes = 0;
 382     attr.SecurityDescriptor = NULL;
 383     attr.SecurityQualityOfService = NULL;
 384     if (options & REG_OPTION_OPEN_LINK) attr.Attributes |= OBJ_OPENLINK;
 385     RtlInitAnsiString( &nameA, name );
 386     RtlInitAnsiString( &classA, class );
 387
 388     if (!(status = RtlAnsiStringToUnicodeString( &NtCurrentTeb()->StaticUnicodeString,
 389                                                  &nameA, FALSE )))
 390     {
 391         if (!(status = RtlAnsiStringToUnicodeString( &classW, &classA, TRUE )))
 392         {
 393             status = create_key( retkey, access, &attr, &classW, options, dispos );
 394             RtlFreeUnicodeString( &classW );
 395         }
 396     }
 397     return RtlNtStatusToDosError( status );
 398 }
 399
 400
 401 /******************************************************************************
 402  * RegCreateKeyW   [ADVAPI32.@]
 403  *
 404  * Creates the specified reg key.
 405  *
 406  * PARAMS
 407  *  hKey      [I] Handle to an open key.
 408  *  lpSubKey  [I] Name of a key that will be opened or created.
 409  *  phkResult [O] Receives a handle to the opened or created key.
 410  *
 411  * RETURNS
 412  *  Success: ERROR_SUCCESS
 413  *  Failure: nonzero error code defined in Winerror.h
 414  */
 415 LSTATUS WINAPI RegCreateKeyW( HKEY hkey, LPCWSTR lpSubKey, PHKEY phkResult )
 416 {
 417     /* FIXME: previous implementation converted ERROR_INVALID_HANDLE to ERROR_BADKEY, */
 418     /* but at least my version of NT (4.0 SP5) doesn't do this.  -- AJ */
 419     return RegCreateKeyExW( hkey, lpSubKey, 0, NULL, REG_OPTION_NON_VOLATILE,
 420                             MAXIMUM_ALLOWED, NULL, phkResult, NULL );
 421 }
 422
 423
 424 /******************************************************************************
 425  * RegCreateKeyA   [ADVAPI32.@]
 426  *
 427  * See RegCreateKeyW.
 428  */
 429 LSTATUS WINAPI RegCreateKeyA( HKEY hkey, LPCSTR lpSubKey, PHKEY phkResult )
 430 {
 431     return RegCreateKeyExA( hkey, lpSubKey, 0, NULL, REG_OPTION_NON_VOLATILE,
 432                             MAXIMUM_ALLOWED, NULL, phkResult, NULL );
 433 }
 434
 435
 436
 437 /******************************************************************************
 438  * RegOpenKeyExW   [ADVAPI32.@]
 439  *
 440  * See RegOpenKeyExA.
 441  */
 442 LSTATUS WINAPI RegOpenKeyExW( HKEY hkey, LPCWSTR name, DWORD options, REGSAM access, PHKEY retkey )
 443 {
 444     OBJECT_ATTRIBUTES attr;
 445     UNICODE_STRING nameW;
 446
 447     /* NT+ allows beginning backslash for HKEY_CLASSES_ROOT */
 448     if (HandleToUlong(hkey) == HandleToUlong(HKEY_CLASSES_ROOT) && name && *name == '\\') name++;
 449
 450     if (!retkey) return ERROR_INVALID_PARAMETER;
 451     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
 452
 453     attr.Length = sizeof(attr);
 454     attr.RootDirectory = hkey;
 455     attr.ObjectName = &nameW;
 456     attr.Attributes = 0;
 457     attr.SecurityDescriptor = NULL;
 458     attr.SecurityQualityOfService = NULL;
 459     if (options & REG_OPTION_OPEN_LINK) attr.Attributes |= OBJ_OPENLINK;
 460     RtlInitUnicodeString( &nameW, name );
 461     return RtlNtStatusToDosError( open_key( retkey, access, &attr ) );
 462 }
 463
 464
 465 /******************************************************************************
 466  * RegOpenKeyExA   [ADVAPI32.@]
 467  *
 468  * Open a registry key.
 469  *
 470  * PARAMS
 471  *  hkey       [I] Handle of open key
 472  *  name       [I] Name of subkey to open
 473  *  options    [I] Open options (can be set to REG_OPTION_OPEN_LINK)
 474  *  access     [I] Security access mask
 475  *  retkey     [O] Handle to open key
 476  *
 477  * RETURNS
 478  *  Success: ERROR_SUCCESS
 479  *  Failure: A standard Win32 error code. retkey is set to 0.
 480  *
 481  * NOTES
 482  *  Unlike RegCreateKeyExA(), this function will not create the key if it
 483  *  does not exist.
 484  */
 485 LSTATUS WINAPI RegOpenKeyExA( HKEY hkey, LPCSTR name, DWORD options, REGSAM access, PHKEY retkey )
 486 {
 487     OBJECT_ATTRIBUTES attr;
 488     STRING nameA;
 489     NTSTATUS status;
 490
 491     if (!is_version_nt()) access = MAXIMUM_ALLOWED;  /* Win95 ignores the access mask */
 492     else
 493     {
 494         /* NT+ allows beginning backslash for HKEY_CLASSES_ROOT */
 495         if (HandleToUlong(hkey) == HandleToUlong(HKEY_CLASSES_ROOT) && name && *name == '\\') name++;
 496     }
 497
 498     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
 499
 500     attr.Length = sizeof(attr);
 501     attr.RootDirectory = hkey;
 502     attr.ObjectName = &NtCurrentTeb()->StaticUnicodeString;
 503     attr.Attributes = 0;
 504     attr.SecurityDescriptor = NULL;
 505     attr.SecurityQualityOfService = NULL;
 506     if (options & REG_OPTION_OPEN_LINK) attr.Attributes |= OBJ_OPENLINK;
 507
 508     RtlInitAnsiString( &nameA, name );
 509     if (!(status = RtlAnsiStringToUnicodeString( &NtCurrentTeb()->StaticUnicodeString,
 510                                                  &nameA, FALSE )))
 511     {
 512         status = open_key( retkey, access, &attr );
 513     }
 514     return RtlNtStatusToDosError( status );
 515 }
 516
 517
 518 /******************************************************************************
 519  * RegOpenKeyW   [ADVAPI32.@]
 520  *
 521  * See RegOpenKeyA.
 522  */
 523 LSTATUS WINAPI RegOpenKeyW( HKEY hkey, LPCWSTR name, PHKEY retkey )
 524 {
 525     if (!retkey)
 526         return ERROR_INVALID_PARAMETER;
 527
 528     if (!name || !*name)
 529     {
 530         *retkey = hkey;
 531         return ERROR_SUCCESS;
 532     }
 533     return RegOpenKeyExW( hkey, name, 0, MAXIMUM_ALLOWED, retkey );
 534 }
 535
 536
 537 /******************************************************************************
 538  * RegOpenKeyA   [ADVAPI32.@]
 539  *
 540  * Open a registry key.
 541  *
 542  * PARAMS
 543  *  hkey    [I] Handle of parent key to open the new key under
 544  *  name    [I] Name of the key under hkey to open
 545  *  retkey  [O] Destination for the resulting Handle
 546  *
 547  * RETURNS
 548  *  Success: ERROR_SUCCESS
 549  *  Failure: A standard Win32 error code. When retkey is valid, *retkey is set to 0.
 550  */
 551 LSTATUS WINAPI RegOpenKeyA( HKEY hkey, LPCSTR name, PHKEY retkey )
 552 {
 553     if (!retkey)
 554         return ERROR_INVALID_PARAMETER;
 555
 556     if (!name || !*name)
 557     {
 558         *retkey = hkey;
 559         return ERROR_SUCCESS;
 560     }
 561     return RegOpenKeyExA( hkey, name, 0, MAXIMUM_ALLOWED, retkey );
 562 }
 563
 564
 565 /******************************************************************************
 566  * RegOpenCurrentUser   [ADVAPI32.@]
 567  *
 568  * Get a handle to the HKEY_CURRENT_USER key for the user
 569  * the current thread is impersonating.
 570  *
 571  * PARAMS
 572  *  access [I] Desired access rights to the key
 573  *  retkey [O] Handle to the opened key
 574  *
 575  * RETURNS
 576  *  Success: ERROR_SUCCESS
 577  *  Failure: nonzero error code from Winerror.h
 578  *
 579  * FIXME
 580  *  This function is supposed to retrieve a handle to the
 581  *  HKEY_CURRENT_USER for the user the current thread is impersonating.
 582  *  Since Wine does not currently allow threads to impersonate other users,
 583  *  this stub should work fine.
 584  */
 585 LSTATUS WINAPI RegOpenCurrentUser( REGSAM access, PHKEY retkey )
 586 {
 587     return RegOpenKeyExA( HKEY_CURRENT_USER, "", 0, access, retkey );
 588 }
 589
 590
 591
 592 /******************************************************************************
 593  * RegEnumKeyExW   [ADVAPI32.@]
 594  *
 595  * Enumerate subkeys of the specified open registry key.
 596  *
 597  * PARAMS
 598  *  hkey         [I] Handle to key to enumerate
 599  *  index        [I] Index of subkey to enumerate
 600  *  name         [O] Buffer for subkey name
 601  *  name_len     [O] Size of subkey buffer
 602  *  reserved     [I] Reserved
 603  *  class        [O] Buffer for class string
 604  *  class_len    [O] Size of class buffer
 605  *  ft           [O] Time key last written to
 606  *
 607  * RETURNS
 608  *  Success: ERROR_SUCCESS
 609  *  Failure: System error code. If there are no more subkeys available, the
 610  *           function returns ERROR_NO_MORE_ITEMS.
 611  */
 612 LSTATUS WINAPI RegEnumKeyExW( HKEY hkey, DWORD index, LPWSTR name, LPDWORD name_len,
 613                            LPDWORD reserved, LPWSTR class, LPDWORD class_len, FILETIME *ft )
 614 {
 615     NTSTATUS status;
 616     char buffer[256], *buf_ptr = buffer;
 617     KEY_NODE_INFORMATION *info = (KEY_NODE_INFORMATION *)buffer;
 618     DWORD total_size;
 619
 620     TRACE( "(%p,%d,%p,%p(%u),%p,%p,%p,%p)\n", hkey, index, name, name_len,
 621            name_len ? *name_len : 0, reserved, class, class_len, ft );
 622
 623     if (reserved) return ERROR_INVALID_PARAMETER;
 624     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
 625
 626     status = NtEnumerateKey( hkey, index, KeyNodeInformation,
 627                              buffer, sizeof(buffer), &total_size );
 628
 629     while (status == STATUS_BUFFER_OVERFLOW)
 630     {
 631         /* retry with a dynamically allocated buffer */
 632         if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
 633         if (!(buf_ptr = HeapAlloc( GetProcessHeap(), 0, total_size )))
 634             return ERROR_NOT_ENOUGH_MEMORY;
 635         info = (KEY_NODE_INFORMATION *)buf_ptr;
 636         status = NtEnumerateKey( hkey, index, KeyNodeInformation,
 637                                  buf_ptr, total_size, &total_size );
 638     }
 639
 640     if (!status)
 641     {
 642         DWORD len = info->NameLength / sizeof(WCHAR);
 643         DWORD cls_len = info->ClassLength / sizeof(WCHAR);
 644
 645         if (ft) *ft = *(FILETIME *)&info->LastWriteTime;
 646
 647         if (len >= *name_len || (class && class_len && (cls_len >= *class_len)))
 648             status = STATUS_BUFFER_OVERFLOW;
 649         else
 650         {
 651             *name_len = len;
 652             memcpy( name, info->Name, info->NameLength );
 653             name[len] = 0;
 654             if (class_len)
 655             {
 656                 *class_len = cls_len;
 657                 if (class)
 658                 {
 659                     memcpy( class, buf_ptr + info->ClassOffset, info->ClassLength );
 660                     class[cls_len] = 0;
 661                 }
 662             }
 663         }
 664     }
 665
 666     if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
 667     return RtlNtStatusToDosError( status );
 668 }
 669
 670
 671 /******************************************************************************
 672  * RegEnumKeyExA   [ADVAPI32.@]
 673  *
 674  * See RegEnumKeyExW.
 675  */
 676 LSTATUS WINAPI RegEnumKeyExA( HKEY hkey, DWORD index, LPSTR name, LPDWORD name_len,
 677                            LPDWORD reserved, LPSTR class, LPDWORD class_len, FILETIME *ft )
 678 {
 679     NTSTATUS status;
 680     char buffer[256], *buf_ptr = buffer;
 681     KEY_NODE_INFORMATION *info = (KEY_NODE_INFORMATION *)buffer;
 682     DWORD total_size;
 683
 684     TRACE( "(%p,%d,%p,%p(%u),%p,%p,%p,%p)\n", hkey, index, name, name_len,
 685            name_len ? *name_len : 0, reserved, class, class_len, ft );
 686
 687     if (reserved) return ERROR_INVALID_PARAMETER;
 688     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
 689
 690     status = NtEnumerateKey( hkey, index, KeyNodeInformation,
 691                              buffer, sizeof(buffer), &total_size );
 692
 693     while (status == STATUS_BUFFER_OVERFLOW)
 694     {
 695         /* retry with a dynamically allocated buffer */
 696         if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
 697         if (!(buf_ptr = HeapAlloc( GetProcessHeap(), 0, total_size )))
 698             return ERROR_NOT_ENOUGH_MEMORY;
 699         info = (KEY_NODE_INFORMATION *)buf_ptr;
 700         status = NtEnumerateKey( hkey, index, KeyNodeInformation,
 701                                  buf_ptr, total_size, &total_size );
 702     }
 703
 704     if (!status)
 705     {
 706         DWORD len, cls_len;
 707
 708         RtlUnicodeToMultiByteSize( &len, info->Name, info->NameLength );
 709         RtlUnicodeToMultiByteSize( &cls_len, (WCHAR *)(buf_ptr + info->ClassOffset),
 710                                    info->ClassLength );
 711         if (ft) *ft = *(FILETIME *)&info->LastWriteTime;
 712
 713         if (len >= *name_len || (class && class_len && (cls_len >= *class_len)))
 714             status = STATUS_BUFFER_OVERFLOW;
 715         else
 716         {
 717             *name_len = len;
 718             RtlUnicodeToMultiByteN( name, len, NULL, info->Name, info->NameLength );
 719             name[len] = 0;
 720             if (class_len)
 721             {
 722                 *class_len = cls_len;
 723                 if (class)
 724                 {
 725                     RtlUnicodeToMultiByteN( class, cls_len, NULL,
 726                                             (WCHAR *)(buf_ptr + info->ClassOffset),
 727                                             info->ClassLength );
 728                     class[cls_len] = 0;
 729                 }
 730             }
 731         }
 732     }
 733
 734     if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
 735     return RtlNtStatusToDosError( status );
 736 }
 737
 738
 739 /******************************************************************************
 740  * RegEnumKeyW   [ADVAPI32.@]
 741  *
 742  * Enumerates subkeys of the specified open reg key.
 743  *
 744  * PARAMS
 745  *  hKey    [I] Handle to an open key.
 746  *  dwIndex [I] Index of the subkey of hKey to retrieve.
 747  *  lpName  [O] Name of the subkey.
 748  *  cchName [I] Size of lpName in TCHARS.
 749  *
 750  * RETURNS
 751  *  Success: ERROR_SUCCESS
 752  *  Failure: system error code. If there are no more subkeys available, the
 753  *           function returns ERROR_NO_MORE_ITEMS.
 754  */
 755 LSTATUS WINAPI RegEnumKeyW( HKEY hkey, DWORD index, LPWSTR name, DWORD name_len )
 756 {
 757     return RegEnumKeyExW( hkey, index, name, &name_len, NULL, NULL, NULL, NULL );
 758 }
 759
 760
 761 /******************************************************************************
 762  * RegEnumKeyA   [ADVAPI32.@]
 763  *
 764  * See RegEnumKeyW.
 765  */
 766 LSTATUS WINAPI RegEnumKeyA( HKEY hkey, DWORD index, LPSTR name, DWORD name_len )
 767 {
 768     return RegEnumKeyExA( hkey, index, name, &name_len, NULL, NULL, NULL, NULL );
 769 }
 770
 771
 772 /******************************************************************************
 773  * RegQueryInfoKeyW   [ADVAPI32.@]
 774  *
 775  * Retrieves information about the specified registry key.
 776  *
 777  * PARAMS
 778  *    hkey       [I] Handle to key to query
 779  *    class      [O] Buffer for class string
 780  *    class_len  [O] Size of class string buffer
 781  *    reserved   [I] Reserved
 782  *    subkeys    [O] Buffer for number of subkeys
 783  *    max_subkey [O] Buffer for longest subkey name length
 784  *    max_class  [O] Buffer for longest class string length
 785  *    values     [O] Buffer for number of value entries
 786  *    max_value  [O] Buffer for longest value name length
 787  *    max_data   [O] Buffer for longest value data length
 788  *    security   [O] Buffer for security descriptor length
 789  *    modif      [O] Modification time
 790  *
 791  * RETURNS
 792  *  Success: ERROR_SUCCESS
 793  *  Failure: system error code.
 794  *
 795  * NOTES
 796  *  - win95 allows class to be valid and class_len to be NULL
 797  *  - winnt returns ERROR_INVALID_PARAMETER if class is valid and class_len is NULL
 798  *  - both allow class to be NULL and class_len to be NULL
 799  *    (it's hard to test validity, so test !NULL instead)
 800  */
 801 LSTATUS WINAPI RegQueryInfoKeyW( HKEY hkey, LPWSTR class, LPDWORD class_len, LPDWORD reserved,
 802                               LPDWORD subkeys, LPDWORD max_subkey, LPDWORD max_class,
 803                               LPDWORD values, LPDWORD max_value, LPDWORD max_data,
 804                               LPDWORD security, FILETIME *modif )
 805 {
 806     NTSTATUS status;
 807     char buffer[256], *buf_ptr = buffer;
 808     KEY_FULL_INFORMATION *info = (KEY_FULL_INFORMATION *)buffer;
 809     DWORD total_size;
 810
 811     TRACE( "(%p,%p,%d,%p,%p,%p,%p,%p,%p,%p,%p)\n", hkey, class, class_len ? *class_len : 0,
 812            reserved, subkeys, max_subkey, values, max_value, max_data, security, modif );
 813
 814     if (class && !class_len && is_version_nt()) return ERROR_INVALID_PARAMETER;
 815     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
 816
 817     status = NtQueryKey( hkey, KeyFullInformation, buffer, sizeof(buffer), &total_size );
 818     if (status && status != STATUS_BUFFER_OVERFLOW) goto done;
 819
 820     if (class)
 821     {
 822         /* retry with a dynamically allocated buffer */
 823         while (status == STATUS_BUFFER_OVERFLOW)
 824         {
 825             if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
 826             if (!(buf_ptr = HeapAlloc( GetProcessHeap(), 0, total_size )))
 827                 return ERROR_NOT_ENOUGH_MEMORY;
 828             info = (KEY_FULL_INFORMATION *)buf_ptr;
 829             status = NtQueryKey( hkey, KeyFullInformation, buf_ptr, total_size, &total_size );
 830         }
 831
 832         if (status) goto done;
 833
 834         if (class_len && (info->ClassLength/sizeof(WCHAR) + 1 > *class_len))
 835         {
 836             status = STATUS_BUFFER_OVERFLOW;
 837         }
 838         else
 839         {
 840             memcpy( class, buf_ptr + info->ClassOffset, info->ClassLength );
 841             class[info->ClassLength/sizeof(WCHAR)] = 0;
 842         }
 843     }
 844     else status = STATUS_SUCCESS;
 845
 846     if (class_len) *class_len = info->ClassLength / sizeof(WCHAR);
 847     if (subkeys) *subkeys = info->SubKeys;
 848     if (max_subkey) *max_subkey = info->MaxNameLen;
 849     if (max_class) *max_class = info->MaxClassLen;
 850     if (values) *values = info->Values;
 851     if (max_value) *max_value = info->MaxValueNameLen;
 852     if (max_data) *max_data = info->MaxValueDataLen;
 853     if (modif) *modif = *(FILETIME *)&info->LastWriteTime;
 854
 855  done:
 856     if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
 857     return RtlNtStatusToDosError( status );
 858 }
 859
 860
 861 /******************************************************************************
 862  * RegQueryMultipleValuesA   [ADVAPI32.@]
 863  *
 864  * Retrieves the type and data for a list of value names associated with a key.
 865  *
 866  * PARAMS
 867  *  hKey       [I] Handle to an open key.
 868  *  val_list   [O] Array of VALENT structures that describes the entries.
 869  *  num_vals   [I] Number of elements in val_list.
 870  *  lpValueBuf [O] Pointer to a buffer that receives the data for each value.
 871  *  ldwTotsize [I/O] Size of lpValueBuf.
 872  *
 873  * RETURNS
 874  *  Success: ERROR_SUCCESS. ldwTotsize contains num bytes copied.
 875  *  Failure: nonzero error code from Winerror.h ldwTotsize contains num needed
 876  *           bytes.
 877  */
 878 LSTATUS WINAPI RegQueryMultipleValuesA( HKEY hkey, PVALENTA val_list, DWORD num_vals,
 879                                      LPSTR lpValueBuf, LPDWORD ldwTotsize )
 880 {
 881     unsigned int i;
 882     DWORD maxBytes = *ldwTotsize;
 883     HRESULT status;
 884     LPSTR bufptr = lpValueBuf;
 885     *ldwTotsize = 0;
 886
 887     TRACE("(%p,%p,%d,%p,%p=%d)\n", hkey, val_list, num_vals, lpValueBuf, ldwTotsize, *ldwTotsize);
 888
 889     for(i=0; i < num_vals; ++i)
 890     {
 891
 892         val_list[i].ve_valuelen=0;
 893         status = RegQueryValueExA(hkey, val_list[i].ve_valuename, NULL, NULL, NULL, &val_list[i].ve_valuelen);
 894         if(status != ERROR_SUCCESS)
 895         {
 896             return status;
 897         }
 898
 899         if(lpValueBuf != NULL && *ldwTotsize + val_list[i].ve_valuelen <= maxBytes)
 900         {
 901             status = RegQueryValueExA(hkey, val_list[i].ve_valuename, NULL, &val_list[i].ve_type,
 902                                       (LPBYTE)bufptr, &val_list[i].ve_valuelen);
 903             if(status != ERROR_SUCCESS)
 904             {
 905                 return status;
 906             }
 907
 908             val_list[i].ve_valueptr = (DWORD_PTR)bufptr;
 909
 910             bufptr += val_list[i].ve_valuelen;
 911         }
 912
 913         *ldwTotsize += val_list[i].ve_valuelen;
 914     }
 915     return lpValueBuf != NULL && *ldwTotsize <= maxBytes ? ERROR_SUCCESS : ERROR_MORE_DATA;
 916 }
 917
 918
 919 /******************************************************************************
 920  * RegQueryMultipleValuesW   [ADVAPI32.@]
 921  *
 922  * See RegQueryMultipleValuesA.
 923  */
 924 LSTATUS WINAPI RegQueryMultipleValuesW( HKEY hkey, PVALENTW val_list, DWORD num_vals,
 925                                      LPWSTR lpValueBuf, LPDWORD ldwTotsize )
 926 {
 927     unsigned int i;
 928     DWORD maxBytes = *ldwTotsize;
 929     HRESULT status;
 930     LPSTR bufptr = (LPSTR)lpValueBuf;
 931     *ldwTotsize = 0;
 932
 933     TRACE("(%p,%p,%d,%p,%p=%d)\n", hkey, val_list, num_vals, lpValueBuf, ldwTotsize, *ldwTotsize);
 934
 935     for(i=0; i < num_vals; ++i)
 936     {
 937         val_list[i].ve_valuelen=0;
 938         status = RegQueryValueExW(hkey, val_list[i].ve_valuename, NULL, NULL, NULL, &val_list[i].ve_valuelen);
 939         if(status != ERROR_SUCCESS)
 940         {
 941             return status;
 942         }
 943
 944         if(lpValueBuf != NULL && *ldwTotsize + val_list[i].ve_valuelen <= maxBytes)
 945         {
 946             status = RegQueryValueExW(hkey, val_list[i].ve_valuename, NULL, &val_list[i].ve_type,
 947                                       (LPBYTE)bufptr, &val_list[i].ve_valuelen);
 948             if(status != ERROR_SUCCESS)
 949             {
 950                 return status;
 951             }
 952
 953             val_list[i].ve_valueptr = (DWORD_PTR)bufptr;
 954
 955             bufptr += val_list[i].ve_valuelen;
 956         }
 957
 958         *ldwTotsize += val_list[i].ve_valuelen;
 959     }
 960     return lpValueBuf != NULL && *ldwTotsize <= maxBytes ? ERROR_SUCCESS : ERROR_MORE_DATA;
 961 }
 962
 963 /******************************************************************************
 964  * RegQueryInfoKeyA   [ADVAPI32.@]
 965  *
 966  * Retrieves information about a registry key.
 967  *
 968  * PARAMS
 969  *  hKey                   [I] Handle to an open key.
 970  *  lpClass                [O] Class string of the key.
 971  *  lpcClass               [I/O] size of lpClass.
 972  *  lpReserved             [I] Reserved; must be NULL.
 973  *  lpcSubKeys             [O] Number of subkeys contained by the key.
 974  *  lpcMaxSubKeyLen        [O] Size of the key's subkey with the longest name.
 975  *  lpcMaxClassLen         [O] Size of the longest string specifying a subkey
 976  *                             class in TCHARS.
 977  *  lpcValues              [O] Number of values associated with the key.
 978  *  lpcMaxValueNameLen     [O] Size of the key's longest value name in TCHARS.
 979  *  lpcMaxValueLen         [O] Longest data component among the key's values
 980  *  lpcbSecurityDescriptor [O] Size of the key's security descriptor.
 981  *  lpftLastWriteTime      [O] FILETIME structure that is the last write time.
 982  *
 983  *  RETURNS
 984  *   Success: ERROR_SUCCESS
 985  *   Failure: nonzero error code from Winerror.h
 986  */
 987 LSTATUS WINAPI RegQueryInfoKeyA( HKEY hkey, LPSTR class, LPDWORD class_len, LPDWORD reserved,
 988                               LPDWORD subkeys, LPDWORD max_subkey, LPDWORD max_class,
 989                               LPDWORD values, LPDWORD max_value, LPDWORD max_data,
 990                               LPDWORD security, FILETIME *modif )
 991 {
 992     NTSTATUS status;
 993     char buffer[256], *buf_ptr = buffer;
 994     KEY_FULL_INFORMATION *info = (KEY_FULL_INFORMATION *)buffer;
 995     DWORD total_size, len;
 996
 997     TRACE( "(%p,%p,%d,%p,%p,%p,%p,%p,%p,%p,%p)\n", hkey, class, class_len ? *class_len : 0,
 998            reserved, subkeys, max_subkey, values, max_value, max_data, security, modif );
 999
1000     if (class && !class_len && is_version_nt()) return ERROR_INVALID_PARAMETER;
1001     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
1002
1003     status = NtQueryKey( hkey, KeyFullInformation, buffer, sizeof(buffer), &total_size );
1004     if (status && status != STATUS_BUFFER_OVERFLOW) goto done;
1005
1006     if (class || class_len)
1007     {
1008         /* retry with a dynamically allocated buffer */
1009         while (status == STATUS_BUFFER_OVERFLOW)
1010         {
1011             if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
1012             if (!(buf_ptr = HeapAlloc( GetProcessHeap(), 0, total_size )))
1013                 return ERROR_NOT_ENOUGH_MEMORY;
1014             info = (KEY_FULL_INFORMATION *)buf_ptr;
1015             status = NtQueryKey( hkey, KeyFullInformation, buf_ptr, total_size, &total_size );
1016         }
1017
1018         if (status) goto done;
1019
1020         RtlUnicodeToMultiByteSize( &len, (WCHAR *)(buf_ptr + info->ClassOffset), info->ClassLength);
1021         if (class_len)
1022         {
1023             if (len + 1 > *class_len) status = STATUS_BUFFER_OVERFLOW;
1024             *class_len = len;
1025         }
1026         if (class && !status)
1027         {
1028             RtlUnicodeToMultiByteN( class, len, NULL, (WCHAR *)(buf_ptr + info->ClassOffset),
1029                                     info->ClassLength );
1030             class[len] = 0;
1031         }
1032     }
1033     else status = STATUS_SUCCESS;
1034
1035     if (subkeys) *subkeys = info->SubKeys;
1036     if (max_subkey) *max_subkey = info->MaxNameLen;
1037     if (max_class) *max_class = info->MaxClassLen;
1038     if (values) *values = info->Values;
1039     if (max_value) *max_value = info->MaxValueNameLen;
1040     if (max_data) *max_data = info->MaxValueDataLen;
1041     if (modif) *modif = *(FILETIME *)&info->LastWriteTime;
1042
1043  done:
1044     if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
1045     return RtlNtStatusToDosError( status );
1046 }
1047
1048
1049 /******************************************************************************
1050  * RegCloseKey   [ADVAPI32.@]
1051  *
1052  * Close an open registry key.
1053  *
1054  * PARAMS
1055  *  hkey [I] Handle of key to close
1056  *
1057  * RETURNS
1058  *  Success: ERROR_SUCCESS
1059  *  Failure: Error code
1060  */
1061 LSTATUS WINAPI RegCloseKey( HKEY hkey )
1062 {
1063     if (!hkey) return ERROR_INVALID_HANDLE;
1064     if (hkey >= (HKEY)0x80000000) return ERROR_SUCCESS;
1065     return RtlNtStatusToDosError( NtClose( hkey ) );
1066 }
1067
1068
1069 /******************************************************************************
1070  * RegDeleteKeyExW   [ADVAPI32.@]
1071  */
1072 LSTATUS WINAPI RegDeleteKeyExW( HKEY hkey, LPCWSTR name, REGSAM access, DWORD reserved )
1073 {
1074     DWORD ret;
1075     HKEY tmp;
1076
1077     if (!name) return ERROR_INVALID_PARAMETER;
1078
1079     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
1080
1081     access &= KEY_WOW64_64KEY | KEY_WOW64_32KEY;
1082     if (!(ret = RegOpenKeyExW( hkey, name, 0, access | DELETE, &tmp )))
1083     {
1084         ret = RtlNtStatusToDosError( NtDeleteKey( tmp ) );
1085         RegCloseKey( tmp );
1086     }
1087     TRACE("%s ret=%08x\n", debugstr_w(name), ret);
1088     return ret;
1089 }
1090
1091
1092 /******************************************************************************
1093  * RegDeleteKeyW   [ADVAPI32.@]
1094  *
1095  * See RegDeleteKeyA.
1096  */
1097 LSTATUS WINAPI RegDeleteKeyW( HKEY hkey, LPCWSTR name )
1098 {
1099     return RegDeleteKeyExW( hkey, name, 0, 0 );
1100 }
1101
1102
1103 /******************************************************************************
1104  * RegDeleteKeyExA   [ADVAPI32.@]
1105  */
1106 LSTATUS WINAPI RegDeleteKeyExA( HKEY hkey, LPCSTR name, REGSAM access, DWORD reserved )
1107 {
1108     DWORD ret;
1109     HKEY tmp;
1110
1111     if (!name) return ERROR_INVALID_PARAMETER;
1112
1113     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
1114
1115     access &= KEY_WOW64_64KEY | KEY_WOW64_32KEY;
1116     if (!(ret = RegOpenKeyExA( hkey, name, 0, access | DELETE, &tmp )))
1117     {
1118         if (!is_version_nt()) /* win95 does recursive key deletes */
1119         {
1120             CHAR sub[MAX_PATH];
1121
1122             while(!RegEnumKeyA(tmp, 0, sub, sizeof(sub)))
1123             {
1124                 if(RegDeleteKeyExA(tmp, sub, access, reserved))  /* recurse */
1125                     break;
1126             }
1127         }
1128         ret = RtlNtStatusToDosError( NtDeleteKey( tmp ) );
1129         RegCloseKey( tmp );
1130     }
1131     TRACE("%s ret=%08x\n", debugstr_a(name), ret);
1132     return ret;
1133 }
1134
1135
1136 /******************************************************************************
1137  * RegDeleteKeyA   [ADVAPI32.@]
1138  *
1139  * Delete a registry key.
1140  *
1141  * PARAMS
1142  *  hkey   [I] Handle to parent key containing the key to delete
1143  *  name   [I] Name of the key user hkey to delete
1144  *
1145  * NOTES
1146  *
1147  * MSDN is wrong when it says that hkey must be opened with the DELETE access
1148  * right. In reality, it opens a new handle with DELETE access.
1149  *
1150  * RETURNS
1151  *  Success: ERROR_SUCCESS
1152  *  Failure: Error code
1153  */
1154 LSTATUS WINAPI RegDeleteKeyA( HKEY hkey, LPCSTR name )
1155 {
1156     return RegDeleteKeyExA( hkey, name, 0, 0 );
1157 }
1158
1159
1160
1161 /******************************************************************************
1162  * RegSetValueExW   [ADVAPI32.@]
1163  *
1164  * Set the data and contents of a registry value.
1165  *
1166  * PARAMS
1167  *  hkey       [I] Handle of key to set value for
1168  *  name       [I] Name of value to set
1169  *  reserved   [I] Reserved, must be zero
1170  *  type       [I] Type of the value being set
1171  *  data       [I] The new contents of the value to set
1172  *  count      [I] Size of data
1173  *
1174  * RETURNS
1175  *  Success: ERROR_SUCCESS
1176  *  Failure: Error code
1177  */
1178 LSTATUS WINAPI RegSetValueExW( HKEY hkey, LPCWSTR name, DWORD reserved,
1179                             DWORD type, CONST BYTE *data, DWORD count )
1180 {
1181     UNICODE_STRING nameW;
1182
1183     /* no need for version check, not implemented on win9x anyway */
1184
1185     if (data && ((ULONG_PTR)data >> 16) == 0) return ERROR_NOACCESS;
1186
1187     if (count && is_string(type))
1188     {
1189         LPCWSTR str = (LPCWSTR)data;
1190         /* if user forgot to count terminating null, add it (yes NT does this) */
1191         if (str[count / sizeof(WCHAR) - 1] && !str[count / sizeof(WCHAR)])
1192             count += sizeof(WCHAR);
1193     }
1194     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
1195
1196     RtlInitUnicodeString( &nameW, name );
1197     return RtlNtStatusToDosError( NtSetValueKey( hkey, &nameW, 0, type, data, count ) );
1198 }
1199
1200
1201 /******************************************************************************
1202  * RegSetValueExA   [ADVAPI32.@]
1203  *
1204  * See RegSetValueExW.
1205  *
1206  * NOTES
1207  *  win95 does not care about count for REG_SZ and finds out the len by itself (js)
1208  *  NT does definitely care (aj)
1209  */
1210 LSTATUS WINAPI RegSetValueExA( HKEY hkey, LPCSTR name, DWORD reserved, DWORD type,
1211                             CONST BYTE *data, DWORD count )
1212 {
1213     ANSI_STRING nameA;
1214     UNICODE_STRING nameW;
1215     WCHAR *dataW = NULL;
1216     NTSTATUS status;
1217
1218     if (!is_version_nt())  /* win95 */
1219     {
1220         if (type == REG_SZ)
1221         {
1222             if (!data) return ERROR_INVALID_PARAMETER;
1223             count = strlen((const char *)data) + 1;
1224         }
1225     }
1226     else if (count && is_string(type))
1227     {
1228         /* if user forgot to count terminating null, add it (yes NT does this) */
1229         if (data[count-1] && !data[count]) count++;
1230     }
1231
1232     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
1233
1234     if (is_string( type )) /* need to convert to Unicode */
1235     {
1236         DWORD lenW;
1237         RtlMultiByteToUnicodeSize( &lenW, (const char *)data, count );
1238         if (!(dataW = HeapAlloc( GetProcessHeap(), 0, lenW ))) return ERROR_OUTOFMEMORY;
1239         RtlMultiByteToUnicodeN( dataW, lenW, NULL, (const char *)data, count );
1240         count = lenW;
1241         data = (BYTE *)dataW;
1242     }
1243
1244     RtlInitAnsiString( &nameA, name );
1245     if (!(status = RtlAnsiStringToUnicodeString( &nameW, &nameA, TRUE )))
1246     {
1247         status = NtSetValueKey( hkey, &nameW, 0, type, data, count );
1248         RtlFreeUnicodeString( &nameW );
1249     }
1250     HeapFree( GetProcessHeap(), 0, dataW );
1251     return RtlNtStatusToDosError( status );
1252 }
1253
1254
1255 /******************************************************************************
1256  * RegSetValueW   [ADVAPI32.@]
1257  *
1258  * Sets the data for the default or unnamed value of a reg key.
1259  *
1260  * PARAMS
1261  *  hKey     [I] Handle to an open key.
1262  *  lpSubKey [I] Name of a subkey of hKey.
1263  *  dwType   [I] Type of information to store.
1264  *  lpData   [I] String that contains the data to set for the default value.
1265  *  cbData   [I] Ignored.
1266  *
1267  * RETURNS
1268  *  Success: ERROR_SUCCESS
1269  *  Failure: nonzero error code from Winerror.h
1270  */
1271 LSTATUS WINAPI RegSetValueW( HKEY hkey, LPCWSTR name, DWORD type, LPCWSTR data, DWORD count )
1272 {
1273     HKEY subkey = hkey;
1274     DWORD ret;
1275
1276     TRACE("(%p,%s,%d,%s,%d)\n", hkey, debugstr_w(name), type, debugstr_w(data), count );
1277
1278     if (type != REG_SZ || !data) return ERROR_INVALID_PARAMETER;
1279
1280     if (name && name[0])  /* need to create the subkey */
1281     {
1282         if ((ret = RegCreateKeyW( hkey, name, &subkey )) != ERROR_SUCCESS) return ret;
1283     }
1284
1285     ret = RegSetValueExW( subkey, NULL, 0, REG_SZ, (const BYTE*)data,
1286                           (strlenW( data ) + 1) * sizeof(WCHAR) );
1287     if (subkey != hkey) RegCloseKey( subkey );
1288     return ret;
1289 }
1290
1291
1292 /******************************************************************************
1293  * RegSetValueA   [ADVAPI32.@]
1294  *
1295  * See RegSetValueW.
1296  */
1297 LSTATUS WINAPI RegSetValueA( HKEY hkey, LPCSTR name, DWORD type, LPCSTR data, DWORD count )
1298 {
1299     HKEY subkey = hkey;
1300     DWORD ret;
1301
1302     TRACE("(%p,%s,%d,%s,%d)\n", hkey, debugstr_a(name), type, debugstr_a(data), count );
1303
1304     if (type != REG_SZ || !data) return ERROR_INVALID_PARAMETER;
1305
1306     if (name && name[0])  /* need to create the subkey */
1307     {
1308         if ((ret = RegCreateKeyA( hkey, name, &subkey )) != ERROR_SUCCESS) return ret;
1309     }
1310     ret = RegSetValueExA( subkey, NULL, 0, REG_SZ, (const BYTE*)data, strlen(data)+1 );
1311     if (subkey != hkey) RegCloseKey( subkey );
1312     return ret;
1313 }
1314
1315
1316
1317 /******************************************************************************
1318  * RegQueryValueExW   [ADVAPI32.@]
1319  *
1320  * See RegQueryValueExA.
1321  */
1322 LSTATUS WINAPI RegQueryValueExW( HKEY hkey, LPCWSTR name, LPDWORD reserved, LPDWORD type,
1323                               LPBYTE data, LPDWORD count )
1324 {
1325     NTSTATUS status;
1326     UNICODE_STRING name_str;
1327     DWORD total_size;
1328     char buffer[256], *buf_ptr = buffer;
1329     KEY_VALUE_PARTIAL_INFORMATION *info = (KEY_VALUE_PARTIAL_INFORMATION *)buffer;
1330     static const int info_size = offsetof( KEY_VALUE_PARTIAL_INFORMATION, Data );
1331
1332     TRACE("(%p,%s,%p,%p,%p,%p=%d)\n",
1333           hkey, debugstr_w(name), reserved, type, data, count,
1334           (count && data) ? *count : 0 );
1335
1336     if ((data && !count) || reserved) return ERROR_INVALID_PARAMETER;
1337     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
1338
1339     RtlInitUnicodeString( &name_str, name );
1340
1341     if (data) total_size = min( sizeof(buffer), *count + info_size );
1342     else
1343     {
1344         total_size = info_size;
1345         if (count) *count = 0;
1346     }
1347
1348     status = NtQueryValueKey( hkey, &name_str, KeyValuePartialInformation,
1349                               buffer, total_size, &total_size );
1350     if (status && status != STATUS_BUFFER_OVERFLOW) goto done;
1351
1352     if (data)
1353     {
1354         /* retry with a dynamically allocated buffer */
1355         while (status == STATUS_BUFFER_OVERFLOW && total_size - info_size <= *count)
1356         {
1357             if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
1358             if (!(buf_ptr = HeapAlloc( GetProcessHeap(), 0, total_size )))
1359                 return ERROR_NOT_ENOUGH_MEMORY;
1360             info = (KEY_VALUE_PARTIAL_INFORMATION *)buf_ptr;
1361             status = NtQueryValueKey( hkey, &name_str, KeyValuePartialInformation,
1362                                       buf_ptr, total_size, &total_size );
1363         }
1364
1365         if (!status)
1366         {
1367             memcpy( data, buf_ptr + info_size, total_size - info_size );
1368             /* if the type is REG_SZ and data is not 0-terminated
1369              * and there is enough space in the buffer NT appends a \0 */
1370             if (total_size - info_size <= *count-sizeof(WCHAR) && is_string(info->Type))
1371             {
1372                 WCHAR *ptr = (WCHAR *)(data + total_size - info_size);
1373                 if (ptr > (WCHAR *)data && ptr[-1]) *ptr = 0;
1374             }
1375         }
1376         else if (status != STATUS_BUFFER_OVERFLOW) goto done;
1377     }
1378     else status = STATUS_SUCCESS;
1379
1380     if (type) *type = info->Type;
1381     if (count) *count = total_size - info_size;
1382
1383  done:
1384     if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
1385     return RtlNtStatusToDosError(status);
1386 }
1387
1388
1389 /******************************************************************************
1390  * RegQueryValueExA   [ADVAPI32.@]
1391  *
1392  * Get the type and contents of a specified value under with a key.
1393  *
1394  * PARAMS
1395  *  hkey      [I]   Handle of the key to query
1396  *  name      [I]   Name of value under hkey to query
1397  *  reserved  [I]   Reserved - must be NULL
1398  *  type      [O]   Destination for the value type, or NULL if not required
1399  *  data      [O]   Destination for the values contents, or NULL if not required
1400  *  count     [I/O] Size of data, updated with the number of bytes returned
1401  *
1402  * RETURNS
1403  *  Success: ERROR_SUCCESS. *count is updated with the number of bytes copied to data.
1404  *  Failure: ERROR_INVALID_HANDLE, if hkey is invalid.
1405  *           ERROR_INVALID_PARAMETER, if any other parameter is invalid.
1406  *           ERROR_MORE_DATA, if on input *count is too small to hold the contents.
1407  *
1408  * NOTES
1409  *   MSDN states that if data is too small it is partially filled. In reality
1410  *   it remains untouched.
1411  */
1412 LSTATUS WINAPI RegQueryValueExA( HKEY hkey, LPCSTR name, LPDWORD reserved, LPDWORD type,
1413                               LPBYTE data, LPDWORD count )
1414 {
1415     NTSTATUS status;
1416     ANSI_STRING nameA;
1417     UNICODE_STRING nameW;
1418     DWORD total_size, datalen = 0;
1419     char buffer[256], *buf_ptr = buffer;
1420     KEY_VALUE_PARTIAL_INFORMATION *info = (KEY_VALUE_PARTIAL_INFORMATION *)buffer;
1421     static const int info_size = offsetof( KEY_VALUE_PARTIAL_INFORMATION, Data );
1422
1423     TRACE("(%p,%s,%p,%p,%p,%p=%d)\n",
1424           hkey, debugstr_a(name), reserved, type, data, count, count ? *count : 0 );
1425
1426     if ((data && !count) || reserved) return ERROR_INVALID_PARAMETER;
1427     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
1428
1429     if (count) datalen = *count;
1430     if (!data && count) *count = 0;
1431
1432     /* this matches Win9x behaviour - NT sets *type to a random value */
1433     if (type) *type = REG_NONE;
1434
1435     RtlInitAnsiString( &nameA, name );
1436     if ((status = RtlAnsiStringToUnicodeString( &nameW, &nameA, TRUE )))
1437         return RtlNtStatusToDosError(status);
1438
1439     status = NtQueryValueKey( hkey, &nameW, KeyValuePartialInformation,
1440                               buffer, sizeof(buffer), &total_size );
1441     if (status && status != STATUS_BUFFER_OVERFLOW) goto done;
1442
1443     /* we need to fetch the contents for a string type even if not requested,
1444      * because we need to compute the length of the ASCII string. */
1445     if (data || is_string(info->Type))
1446     {
1447         /* retry with a dynamically allocated buffer */
1448         while (status == STATUS_BUFFER_OVERFLOW)
1449         {
1450             if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
1451             if (!(buf_ptr = HeapAlloc( GetProcessHeap(), 0, total_size )))
1452             {
1453                 status = STATUS_NO_MEMORY;
1454                 goto done;
1455             }
1456             info = (KEY_VALUE_PARTIAL_INFORMATION *)buf_ptr;
1457             status = NtQueryValueKey( hkey, &nameW, KeyValuePartialInformation,
1458                                       buf_ptr, total_size, &total_size );
1459         }
1460
1461         if (status) goto done;
1462
1463         if (is_string(info->Type))
1464         {
1465             DWORD len;
1466
1467             RtlUnicodeToMultiByteSize( &len, (WCHAR *)(buf_ptr + info_size),
1468                                        total_size - info_size );
1469             if (data && len)
1470             {
1471                 if (len > datalen) status = STATUS_BUFFER_OVERFLOW;
1472                 else
1473                 {
1474                     RtlUnicodeToMultiByteN( (char*)data, len, NULL, (WCHAR *)(buf_ptr + info_size),
1475                                             total_size - info_size );
1476                     /* if the type is REG_SZ and data is not 0-terminated
1477                      * and there is enough space in the buffer NT appends a \0 */
1478                     if (len < datalen && data[len-1]) data[len] = 0;
1479                 }
1480             }
1481             total_size = len + info_size;
1482         }
1483         else if (data)
1484         {
1485             if (total_size - info_size > datalen) status = STATUS_BUFFER_OVERFLOW;
1486             else memcpy( data, buf_ptr + info_size, total_size - info_size );
1487         }
1488     }
1489     else status = STATUS_SUCCESS;
1490
1491     if (type) *type = info->Type;
1492     if (count) *count = total_size - info_size;
1493
1494  done:
1495     if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
1496     RtlFreeUnicodeString( &nameW );
1497     return RtlNtStatusToDosError(status);
1498 }
1499
1500
1501 /******************************************************************************
1502  * RegQueryValueW   [ADVAPI32.@]
1503  *
1504  * Retrieves the data associated with the default or unnamed value of a key.
1505  *
1506  * PARAMS
1507  *  hkey      [I] Handle to an open key.
1508  *  name      [I] Name of the subkey of hKey.
1509  *  data      [O] Receives the string associated with the default value
1510  *                of the key.
1511  *  count     [I/O] Size of lpValue in bytes.
1512  *
1513  *  RETURNS
1514  *   Success: ERROR_SUCCESS
1515  *   Failure: nonzero error code from Winerror.h
1516  */
1517 LSTATUS WINAPI RegQueryValueW( HKEY hkey, LPCWSTR name, LPWSTR data, LPLONG count )
1518 {
1519     DWORD ret;
1520     HKEY subkey = hkey;
1521
1522     TRACE("(%p,%s,%p,%d)\n", hkey, debugstr_w(name), data, count ? *count : 0 );
1523
1524     if (name && name[0])
1525     {
1526         if ((ret = RegOpenKeyW( hkey, name, &subkey )) != ERROR_SUCCESS) return ret;
1527     }
1528     ret = RegQueryValueExW( subkey, NULL, NULL, NULL, (LPBYTE)data, (LPDWORD)count );
1529     if (subkey != hkey) RegCloseKey( subkey );
1530     if (ret == ERROR_FILE_NOT_FOUND)
1531     {
1532         /* return empty string if default value not found */
1533         if (data) *data = 0;
1534         if (count) *count = sizeof(WCHAR);
1535         ret = ERROR_SUCCESS;
1536     }
1537     return ret;
1538 }
1539
1540
1541 /******************************************************************************
1542  * RegQueryValueA   [ADVAPI32.@]
1543  *
1544  * See RegQueryValueW.
1545  */
1546 LSTATUS WINAPI RegQueryValueA( HKEY hkey, LPCSTR name, LPSTR data, LPLONG count )
1547 {
1548     DWORD ret;
1549     HKEY subkey = hkey;
1550
1551     TRACE("(%p,%s,%p,%d)\n", hkey, debugstr_a(name), data, count ? *count : 0 );
1552
1553     if (name && name[0])
1554     {
1555         if ((ret = RegOpenKeyA( hkey, name, &subkey )) != ERROR_SUCCESS) return ret;
1556     }
1557     ret = RegQueryValueExA( subkey, NULL, NULL, NULL, (LPBYTE)data, (LPDWORD)count );
1558     if (subkey != hkey) RegCloseKey( subkey );
1559     if (ret == ERROR_FILE_NOT_FOUND)
1560     {
1561         /* return empty string if default value not found */
1562         if (data) *data = 0;
1563         if (count) *count = 1;
1564         ret = ERROR_SUCCESS;
1565     }
1566     return ret;
1567 }
1568
1569
1570 /******************************************************************************
1571  * ADVAPI_ApplyRestrictions   [internal]
1572  *
1573  * Helper function for RegGetValueA/W.
1574  */
1575 static VOID ADVAPI_ApplyRestrictions( DWORD dwFlags, DWORD dwType,
1576                                       DWORD cbData, PLONG ret )
1577 {
1578     /* Check if the type is restricted by the passed flags */
1579     if (*ret == ERROR_SUCCESS || *ret == ERROR_MORE_DATA)
1580     {
1581         DWORD dwMask = 0;
1582
1583         switch (dwType)
1584         {
1585         case REG_NONE: dwMask = RRF_RT_REG_NONE; break;
1586         case REG_SZ: dwMask = RRF_RT_REG_SZ; break;
1587         case REG_EXPAND_SZ: dwMask = RRF_RT_REG_EXPAND_SZ; break;
1588         case REG_MULTI_SZ: dwMask = RRF_RT_REG_MULTI_SZ; break;
1589         case REG_BINARY: dwMask = RRF_RT_REG_BINARY; break;
1590         case REG_DWORD: dwMask = RRF_RT_REG_DWORD; break;
1591         case REG_QWORD: dwMask = RRF_RT_REG_QWORD; break;
1592         }
1593
1594         if (dwFlags & dwMask)
1595         {
1596             /* Type is not restricted, check for size mismatch */
1597             if (dwType == REG_BINARY)
1598             {
1599                 DWORD cbExpect = 0;
1600
1601                 if ((dwFlags & RRF_RT_ANY) == RRF_RT_DWORD)
1602                     cbExpect = 4;
1603                 else if ((dwFlags & RRF_RT_ANY) == RRF_RT_QWORD)
1604                     cbExpect = 8;
1605
1606                 if (cbExpect && cbData != cbExpect)
1607                     *ret = ERROR_DATATYPE_MISMATCH;
1608             }
1609         }
1610         else *ret = ERROR_UNSUPPORTED_TYPE;
1611     }
1612 }
1613
1614
1615 /******************************************************************************
1616  * RegGetValueW   [ADVAPI32.@]
1617  *
1618  * Retrieves the type and data for a value name associated with a key,
1619  * optionally expanding its content and restricting its type.
1620  *
1621  * PARAMS
1622  *  hKey      [I] Handle to an open key.
1623  *  pszSubKey [I] Name of the subkey of hKey.
1624  *  pszValue  [I] Name of value under hKey/szSubKey to query.
1625  *  dwFlags   [I] Flags restricting the value type to retrieve.
1626  *  pdwType   [O] Destination for the values type, may be NULL.
1627  *  pvData    [O] Destination for the values content, may be NULL.
1628  *  pcbData   [I/O] Size of pvData, updated with the size in bytes required to
1629  *                  retrieve the whole content, including the trailing '\0'
1630  *                  for strings.
1631  *
1632  * RETURNS
1633  *  Success: ERROR_SUCCESS
1634  *  Failure: nonzero error code from Winerror.h
1635  *
1636  * NOTES
1637  *  - Unless RRF_NOEXPAND is specified, REG_EXPAND_SZ values are automatically
1638  *    expanded and pdwType is set to REG_SZ instead.
1639  *  - Restrictions are applied after expanding, using RRF_RT_REG_EXPAND_SZ
1640  *    without RRF_NOEXPAND is thus not allowed.
1641  *    An exception is the case where RRF_RT_ANY is specified, because then
1642  *    RRF_NOEXPAND is allowed.
1643  */
1644 LSTATUS WINAPI RegGetValueW( HKEY hKey, LPCWSTR pszSubKey, LPCWSTR pszValue,
1645                           DWORD dwFlags, LPDWORD pdwType, PVOID pvData,
1646                           LPDWORD pcbData )
1647 {
1648     DWORD dwType, cbData = pcbData ? *pcbData : 0;
1649     PVOID pvBuf = NULL;
1650     LONG ret;
1651
1652     TRACE("(%p,%s,%s,%d,%p,%p,%p=%d)\n",
1653           hKey, debugstr_w(pszSubKey), debugstr_w(pszValue), dwFlags, pdwType,
1654           pvData, pcbData, cbData);
1655
1656     if (pvData && !pcbData)
1657         return ERROR_INVALID_PARAMETER;
1658     if ((dwFlags & RRF_RT_REG_EXPAND_SZ) && !(dwFlags & RRF_NOEXPAND) &&
1659             ((dwFlags & RRF_RT_ANY) != RRF_RT_ANY))
1660         return ERROR_INVALID_PARAMETER;
1661
1662     if (pszSubKey && pszSubKey[0])
1663     {
1664         ret = RegOpenKeyExW(hKey, pszSubKey, 0, KEY_QUERY_VALUE, &hKey);
1665         if (ret != ERROR_SUCCESS) return ret;
1666     }
1667
1668     ret = RegQueryValueExW(hKey, pszValue, NULL, &dwType, pvData, &cbData);
1669
1670     /* If we are going to expand we need to read in the whole the value even
1671      * if the passed buffer was too small as the expanded string might be
1672      * smaller than the unexpanded one and could fit into cbData bytes. */
1673     if ((ret == ERROR_SUCCESS || ret == ERROR_MORE_DATA) &&
1674         dwType == REG_EXPAND_SZ && !(dwFlags & RRF_NOEXPAND))
1675     {
1676         do {
1677             HeapFree(GetProcessHeap(), 0, pvBuf);
1678
1679             pvBuf = HeapAlloc(GetProcessHeap(), 0, cbData);
1680             if (!pvBuf)
1681             {
1682                 ret = ERROR_NOT_ENOUGH_MEMORY;
1683                 break;
1684             }
1685
1686             if (ret == ERROR_MORE_DATA || !pvData)
1687                 ret = RegQueryValueExW(hKey, pszValue, NULL,
1688                                        &dwType, pvBuf, &cbData);
1689             else
1690             {
1691                 /* Even if cbData was large enough we have to copy the
1692                  * string since ExpandEnvironmentStrings can't handle
1693                  * overlapping buffers. */
1694                 CopyMemory(pvBuf, pvData, cbData);
1695             }
1696
1697             /* Both the type or the value itself could have been modified in
1698              * between so we have to keep retrying until the buffer is large
1699              * enough or we no longer have to expand the value. */
1700         } while (dwType == REG_EXPAND_SZ && ret == ERROR_MORE_DATA);
1701
1702         if (ret == ERROR_SUCCESS)
1703         {
1704             /* Recheck dwType in case it changed since the first call */
1705             if (dwType == REG_EXPAND_SZ)
1706             {
1707                 cbData = ExpandEnvironmentStringsW(pvBuf, pvData,
1708                                                    pcbData ? *pcbData : 0) * sizeof(WCHAR);
1709                 dwType = REG_SZ;
1710                 if(pvData && pcbData && cbData > *pcbData)
1711                     ret = ERROR_MORE_DATA;
1712             }
1713             else if (pvData)
1714                 CopyMemory(pvData, pvBuf, *pcbData);
1715         }
1716
1717         HeapFree(GetProcessHeap(), 0, pvBuf);
1718     }
1719
1720     if (pszSubKey && pszSubKey[0])
1721         RegCloseKey(hKey);
1722
1723     ADVAPI_ApplyRestrictions(dwFlags, dwType, cbData, &ret);
1724
1725     if (pvData && ret != ERROR_SUCCESS && (dwFlags & RRF_ZEROONFAILURE))
1726         ZeroMemory(pvData, *pcbData);
1727
1728     if (pdwType) *pdwType = dwType;
1729     if (pcbData) *pcbData = cbData;
1730
1731     return ret;
1732 }
1733
1734
1735 /******************************************************************************
1736  * RegGetValueA   [ADVAPI32.@]
1737  *
1738  * See RegGetValueW.
1739  */
1740 LSTATUS WINAPI RegGetValueA( HKEY hKey, LPCSTR pszSubKey, LPCSTR pszValue,
1741                           DWORD dwFlags, LPDWORD pdwType, PVOID pvData,
1742                           LPDWORD pcbData )
1743 {
1744     DWORD dwType, cbData = pcbData ? *pcbData : 0;
1745     PVOID pvBuf = NULL;
1746     LONG ret;
1747
1748     TRACE("(%p,%s,%s,%d,%p,%p,%p=%d)\n",
1749           hKey, debugstr_a(pszSubKey), debugstr_a(pszValue), dwFlags,
1750           pdwType, pvData, pcbData, cbData);
1751
1752     if (pvData && !pcbData)
1753         return ERROR_INVALID_PARAMETER;
1754     if ((dwFlags & RRF_RT_REG_EXPAND_SZ) && !(dwFlags & RRF_NOEXPAND) &&
1755             ((dwFlags & RRF_RT_ANY) != RRF_RT_ANY))
1756         return ERROR_INVALID_PARAMETER;
1757
1758     if (pszSubKey && pszSubKey[0])
1759     {
1760         ret = RegOpenKeyExA(hKey, pszSubKey, 0, KEY_QUERY_VALUE, &hKey);
1761         if (ret != ERROR_SUCCESS) return ret;
1762     }
1763
1764     ret = RegQueryValueExA(hKey, pszValue, NULL, &dwType, pvData, &cbData);
1765
1766     /* If we are going to expand we need to read in the whole the value even
1767      * if the passed buffer was too small as the expanded string might be
1768      * smaller than the unexpanded one and could fit into cbData bytes. */
1769     if ((ret == ERROR_SUCCESS || ret == ERROR_MORE_DATA) &&
1770         dwType == REG_EXPAND_SZ && !(dwFlags & RRF_NOEXPAND))
1771     {
1772         do {
1773             HeapFree(GetProcessHeap(), 0, pvBuf);
1774
1775             pvBuf = HeapAlloc(GetProcessHeap(), 0, cbData);
1776             if (!pvBuf)
1777             {
1778                 ret = ERROR_NOT_ENOUGH_MEMORY;
1779                 break;
1780             }
1781
1782             if (ret == ERROR_MORE_DATA || !pvData)
1783                 ret = RegQueryValueExA(hKey, pszValue, NULL,
1784                                        &dwType, pvBuf, &cbData);
1785             else
1786             {
1787                 /* Even if cbData was large enough we have to copy the
1788                  * string since ExpandEnvironmentStrings can't handle
1789                  * overlapping buffers. */
1790                 CopyMemory(pvBuf, pvData, cbData);
1791             }
1792
1793             /* Both the type or the value itself could have been modified in
1794              * between so we have to keep retrying until the buffer is large
1795              * enough or we no longer have to expand the value. */
1796         } while (dwType == REG_EXPAND_SZ && ret == ERROR_MORE_DATA);
1797
1798         if (ret == ERROR_SUCCESS)
1799         {
1800             /* Recheck dwType in case it changed since the first call */
1801             if (dwType == REG_EXPAND_SZ)
1802             {
1803                 cbData = ExpandEnvironmentStringsA(pvBuf, pvData,
1804                                                    pcbData ? *pcbData : 0);
1805                 dwType = REG_SZ;
1806                 if(pvData && pcbData && cbData > *pcbData)
1807                     ret = ERROR_MORE_DATA;
1808             }
1809             else if (pvData)
1810                 CopyMemory(pvData, pvBuf, *pcbData);
1811         }
1812
1813         HeapFree(GetProcessHeap(), 0, pvBuf);
1814     }
1815
1816     if (pszSubKey && pszSubKey[0])
1817         RegCloseKey(hKey);
1818
1819     ADVAPI_ApplyRestrictions(dwFlags, dwType, cbData, &ret);
1820
1821     if (pvData && ret != ERROR_SUCCESS && (dwFlags & RRF_ZEROONFAILURE))
1822         ZeroMemory(pvData, *pcbData);
1823
1824     if (pdwType) *pdwType = dwType;
1825     if (pcbData) *pcbData = cbData;
1826
1827     return ret;
1828 }
1829
1830
1831 /******************************************************************************
1832  * RegEnumValueW   [ADVAPI32.@]
1833  *
1834  * Enumerates the values for the specified open registry key.
1835  *
1836  * PARAMS
1837  *  hkey       [I] Handle to key to query
1838  *  index      [I] Index of value to query
1839  *  value      [O] Value string
1840  *  val_count  [I/O] Size of value buffer (in wchars)
1841  *  reserved   [I] Reserved
1842  *  type       [O] Type code
1843  *  data       [O] Value data
1844  *  count      [I/O] Size of data buffer (in bytes)
1845  *
1846  * RETURNS
1847  *  Success: ERROR_SUCCESS
1848  *  Failure: nonzero error code from Winerror.h
1849  */
1850
1851 LSTATUS WINAPI RegEnumValueW( HKEY hkey, DWORD index, LPWSTR value, LPDWORD val_count,
1852                            LPDWORD reserved, LPDWORD type, LPBYTE data, LPDWORD count )
1853 {
1854     NTSTATUS status;
1855     DWORD total_size;
1856     char buffer[256], *buf_ptr = buffer;
1857     KEY_VALUE_FULL_INFORMATION *info = (KEY_VALUE_FULL_INFORMATION *)buffer;
1858     static const int info_size = offsetof( KEY_VALUE_FULL_INFORMATION, Name );
1859
1860     TRACE("(%p,%d,%p,%p,%p,%p,%p,%p)\n",
1861           hkey, index, value, val_count, reserved, type, data, count );
1862
1863     /* NT only checks count, not val_count */
1864     if ((data && !count) || reserved) return ERROR_INVALID_PARAMETER;
1865     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
1866
1867     total_size = info_size + (MAX_PATH + 1) * sizeof(WCHAR);
1868     if (data) total_size += *count;
1869     total_size = min( sizeof(buffer), total_size );
1870
1871     status = NtEnumerateValueKey( hkey, index, KeyValueFullInformation,
1872                                   buffer, total_size, &total_size );
1873     if (status && status != STATUS_BUFFER_OVERFLOW) goto done;
1874
1875     if (value || data)
1876     {
1877         /* retry with a dynamically allocated buffer */
1878         while (status == STATUS_BUFFER_OVERFLOW)
1879         {
1880             if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
1881             if (!(buf_ptr = HeapAlloc( GetProcessHeap(), 0, total_size )))
1882                 return ERROR_NOT_ENOUGH_MEMORY;
1883             info = (KEY_VALUE_FULL_INFORMATION *)buf_ptr;
1884             status = NtEnumerateValueKey( hkey, index, KeyValueFullInformation,
1885                                           buf_ptr, total_size, &total_size );
1886         }
1887
1888         if (status) goto done;
1889
1890         if (value)
1891         {
1892             if (info->NameLength/sizeof(WCHAR) >= *val_count)
1893             {
1894                 status = STATUS_BUFFER_OVERFLOW;
1895                 goto overflow;
1896             }
1897             memcpy( value, info->Name, info->NameLength );
1898             *val_count = info->NameLength / sizeof(WCHAR);
1899             value[*val_count] = 0;
1900         }
1901
1902         if (data)
1903         {
1904             if (total_size - info->DataOffset > *count)
1905             {
1906                 status = STATUS_BUFFER_OVERFLOW;
1907                 goto overflow;
1908             }
1909             memcpy( data, buf_ptr + info->DataOffset, total_size - info->DataOffset );
1910             if (total_size - info->DataOffset <= *count-sizeof(WCHAR) && is_string(info->Type))
1911             {
1912                 /* if the type is REG_SZ and data is not 0-terminated
1913                  * and there is enough space in the buffer NT appends a \0 */
1914                 WCHAR *ptr = (WCHAR *)(data + total_size - info->DataOffset);
1915                 if (ptr > (WCHAR *)data && ptr[-1]) *ptr = 0;
1916             }
1917         }
1918     }
1919     else status = STATUS_SUCCESS;
1920
1921  overflow:
1922     if (type) *type = info->Type;
1923     if (count) *count = info->DataLength;
1924
1925  done:
1926     if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
1927     return RtlNtStatusToDosError(status);
1928 }
1929
1930
1931 /******************************************************************************
1932  * RegEnumValueA   [ADVAPI32.@]
1933  *
1934  * See RegEnumValueW.
1935  */
1936 LSTATUS WINAPI RegEnumValueA( HKEY hkey, DWORD index, LPSTR value, LPDWORD val_count,
1937                            LPDWORD reserved, LPDWORD type, LPBYTE data, LPDWORD count )
1938 {
1939     NTSTATUS status;
1940     DWORD total_size;
1941     char buffer[256], *buf_ptr = buffer;
1942     KEY_VALUE_FULL_INFORMATION *info = (KEY_VALUE_FULL_INFORMATION *)buffer;
1943     static const int info_size = offsetof( KEY_VALUE_FULL_INFORMATION, Name );
1944
1945     TRACE("(%p,%d,%p,%p,%p,%p,%p,%p)\n",
1946           hkey, index, value, val_count, reserved, type, data, count );
1947
1948     /* NT only checks count, not val_count */
1949     if ((data && !count) || reserved) return ERROR_INVALID_PARAMETER;
1950     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
1951
1952     total_size = info_size + (MAX_PATH + 1) * sizeof(WCHAR);
1953     if (data) total_size += *count;
1954     total_size = min( sizeof(buffer), total_size );
1955
1956     status = NtEnumerateValueKey( hkey, index, KeyValueFullInformation,
1957                                   buffer, total_size, &total_size );
1958     if (status && status != STATUS_BUFFER_OVERFLOW) goto done;
1959
1960     /* we need to fetch the contents for a string type even if not requested,
1961      * because we need to compute the length of the ASCII string. */
1962     if (value || data || is_string(info->Type))
1963     {
1964         /* retry with a dynamically allocated buffer */
1965         while (status == STATUS_BUFFER_OVERFLOW)
1966         {
1967             if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
1968             if (!(buf_ptr = HeapAlloc( GetProcessHeap(), 0, total_size )))
1969                 return ERROR_NOT_ENOUGH_MEMORY;
1970             info = (KEY_VALUE_FULL_INFORMATION *)buf_ptr;
1971             status = NtEnumerateValueKey( hkey, index, KeyValueFullInformation,
1972                                           buf_ptr, total_size, &total_size );
1973         }
1974
1975         if (status) goto done;
1976
1977         if (is_string(info->Type))
1978         {
1979             DWORD len;
1980             RtlUnicodeToMultiByteSize( &len, (WCHAR *)(buf_ptr + info->DataOffset),
1981                                        total_size - info->DataOffset );
1982             if (data && len)
1983             {
1984                 if (len > *count) status = STATUS_BUFFER_OVERFLOW;
1985                 else
1986                 {
1987                     RtlUnicodeToMultiByteN( (char*)data, len, NULL, (WCHAR *)(buf_ptr + info->DataOffset),
1988                                             total_size - info->DataOffset );
1989                     /* if the type is REG_SZ and data is not 0-terminated
1990                      * and there is enough space in the buffer NT appends a \0 */
1991                     if (len < *count && data[len-1]) data[len] = 0;
1992                 }
1993             }
1994             info->DataLength = len;
1995         }
1996         else if (data)
1997         {
1998             if (total_size - info->DataOffset > *count) status = STATUS_BUFFER_OVERFLOW;
1999             else memcpy( data, buf_ptr + info->DataOffset, total_size - info->DataOffset );
2000         }
2001
2002         if (value && !status)
2003         {
2004             DWORD len;
2005
2006             RtlUnicodeToMultiByteSize( &len, info->Name, info->NameLength );
2007             if (len >= *val_count)
2008             {
2009                 status = STATUS_BUFFER_OVERFLOW;
2010                 if (*val_count)
2011                 {
2012                     len = *val_count - 1;
2013                     RtlUnicodeToMultiByteN( value, len, NULL, info->Name, info->NameLength );
2014                     value[len] = 0;
2015                 }
2016             }
2017             else
2018             {
2019                 RtlUnicodeToMultiByteN( value, len, NULL, info->Name, info->NameLength );
2020                 value[len] = 0;
2021                 *val_count = len;
2022             }
2023         }
2024     }
2025     else status = STATUS_SUCCESS;
2026
2027     if (type) *type = info->Type;
2028     if (count) *count = info->DataLength;
2029
2030  done:
2031     if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
2032     return RtlNtStatusToDosError(status);
2033 }
2034
2035
2036
2037 /******************************************************************************
2038  * RegDeleteValueW   [ADVAPI32.@]
2039  *
2040  * See RegDeleteValueA.
2041  */
2042 LSTATUS WINAPI RegDeleteValueW( HKEY hkey, LPCWSTR name )
2043 {
2044     UNICODE_STRING nameW;
2045
2046     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
2047
2048     RtlInitUnicodeString( &nameW, name );
2049     return RtlNtStatusToDosError( NtDeleteValueKey( hkey, &nameW ) );
2050 }
2051
2052
2053 /******************************************************************************
2054  * RegDeleteValueA   [ADVAPI32.@]
2055  *
2056  * Delete a value from the registry.
2057  *
2058  * PARAMS
2059  *  hkey [I] Registry handle of the key holding the value
2060  *  name [I] Name of the value under hkey to delete
2061  *
2062  * RETURNS
2063  *  Success: ERROR_SUCCESS
2064  *  Failure: nonzero error code from Winerror.h
2065  */
2066 LSTATUS WINAPI RegDeleteValueA( HKEY hkey, LPCSTR name )
2067 {
2068     ANSI_STRING nameA;
2069     UNICODE_STRING nameW;
2070     NTSTATUS status;
2071
2072     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
2073
2074     RtlInitAnsiString( &nameA, name );
2075     if (!(status = RtlAnsiStringToUnicodeString( &nameW, &nameA, TRUE )))
2076     {
2077         status = NtDeleteValueKey( hkey, &nameW );
2078         RtlFreeUnicodeString( &nameW );
2079     }
2080     return RtlNtStatusToDosError( status );
2081 }
2082
2083
2084 /******************************************************************************
2085  * RegLoadKeyW   [ADVAPI32.@]
2086  *
2087  * Create a subkey under HKEY_USERS or HKEY_LOCAL_MACHINE and store
2088  * registration information from a specified file into that subkey.
2089  *
2090  * PARAMS
2091  *  hkey      [I] Handle of open key
2092  *  subkey    [I] Address of name of subkey
2093  *  filename  [I] Address of filename for registry information
2094  *
2095  * RETURNS
2096  *  Success: ERROR_SUCCESS
2097  *  Failure: nonzero error code from Winerror.h
2098  */
2099 LSTATUS WINAPI RegLoadKeyW( HKEY hkey, LPCWSTR subkey, LPCWSTR filename )
2100 {
2101     OBJECT_ATTRIBUTES destkey, file;
2102     UNICODE_STRING subkeyW, filenameW;
2103     NTSTATUS status;
2104
2105     if (!(hkey = get_special_root_hkey(hkey))) return ERROR_INVALID_HANDLE;
2106
2107     destkey.Length = sizeof(destkey);
2108     destkey.RootDirectory = hkey;               /* root key: HKLM or HKU */
2109     destkey.ObjectName = &subkeyW;              /* name of the key */
2110     destkey.Attributes = 0;
2111     destkey.SecurityDescriptor = NULL;
2112     destkey.SecurityQualityOfService = NULL;
2113     RtlInitUnicodeString(&subkeyW, subkey);
2114
2115     file.Length = sizeof(file);
2116     file.RootDirectory = NULL;
2117     file.ObjectName = &filenameW;               /* file containing the hive */
2118     file.Attributes = OBJ_CASE_INSENSITIVE;
2119     file.SecurityDescriptor = NULL;
2120     file.SecurityQualityOfService = NULL;
2121     RtlDosPathNameToNtPathName_U(filename, &filenameW, NULL, NULL);
2122
2123     status = NtLoadKey(&destkey, &file);
2124     RtlFreeUnicodeString(&filenameW);
2125     return RtlNtStatusToDosError( status );
2126 }
2127
2128
2129 /******************************************************************************
2130  * RegLoadKeyA   [ADVAPI32.@]
2131  *
2132  * See RegLoadKeyW.
2133  */
2134 LSTATUS WINAPI RegLoadKeyA( HKEY hkey, LPCSTR subkey, LPCSTR filename )
2135 {
2136     UNICODE_STRING subkeyW, filenameW;
2137     STRING subkeyA, filenameA;
2138     NTSTATUS status;
2139     LONG ret;
2140
2141     RtlInitAnsiString(&subkeyA, subkey);
2142     RtlInitAnsiString(&filenameA, filename);
2143
2144     RtlInitUnicodeString(&subkeyW, NULL);
2145     RtlInitUnicodeString(&filenameW, NULL);
2146     if (!(status = RtlAnsiStringToUnicodeString(&subkeyW, &subkeyA, TRUE)) &&
2147         !(status = RtlAnsiStringToUnicodeString(&filenameW, &filenameA, TRUE)))
2148     {
2149         ret = RegLoadKeyW(hkey, subkeyW.Buffer, filenameW.Buffer);
2150     }
2151     else ret = RtlNtStatusToDosError(status);
2152     RtlFreeUnicodeString(&subkeyW);
2153     RtlFreeUnicodeString(&filenameW);
2154     return ret;
2155 }
2156
2157
2158 /******************************************************************************
2159  * RegSaveKeyW   [ADVAPI32.@]
2160  *
2161  * Save a key and all of its subkeys and values to a new file in the standard format.
2162  *
2163  * PARAMS
2164  *  hkey   [I] Handle of key where save begins
2165  *  lpFile [I] Address of filename to save to
2166  *  sa     [I] Address of security structure
2167  *
2168  * RETURNS
2169  *  Success: ERROR_SUCCESS
2170  *  Failure: nonzero error code from Winerror.h
2171  */
2172 LSTATUS WINAPI RegSaveKeyW( HKEY hkey, LPCWSTR file, LPSECURITY_ATTRIBUTES sa )
2173 {
2174     static const WCHAR format[] =
2175         {'r','e','g','%','0','4','x','.','t','m','p',0};
2176     WCHAR buffer[MAX_PATH];
2177     int count = 0;
2178     LPWSTR nameW;
2179     DWORD ret, err;
2180     HANDLE handle;
2181
2182     TRACE( "(%p,%s,%p)\n", hkey, debugstr_w(file), sa );
2183
2184     if (!file || !*file) return ERROR_INVALID_PARAMETER;
2185     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
2186
2187     err = GetLastError();
2188     GetFullPathNameW( file, sizeof(buffer)/sizeof(WCHAR), buffer, &nameW );
2189
2190     for (;;)
2191     {
2192         snprintfW( nameW, 16, format, count++ );
2193         handle = CreateFileW( buffer, GENERIC_WRITE, 0, NULL,
2194                             CREATE_NEW, FILE_ATTRIBUTE_NORMAL, 0 );
2195         if (handle != INVALID_HANDLE_VALUE) break;
2196         if ((ret = GetLastError()) != ERROR_FILE_EXISTS) goto done;
2197
2198         /* Something gone haywire ? Please report if this happens abnormally */
2199         if (count >= 100)
2200             MESSAGE("Wow, we are already fiddling with a temp file %s with an ordinal as high as %d !\nYou might want to delete all corresponding temp files in that directory.\n", debugstr_w(buffer), count);
2201     }
2202
2203     ret = RtlNtStatusToDosError(NtSaveKey(hkey, handle));
2204
2205     CloseHandle( handle );
2206     if (!ret)
2207     {
2208         if (!MoveFileExW( buffer, file, MOVEFILE_REPLACE_EXISTING ))
2209         {
2210             ERR( "Failed to move %s to %s\n", debugstr_w(buffer),
2211                 debugstr_w(file) );
2212             ret = GetLastError();
2213         }
2214     }
2215     if (ret) DeleteFileW( buffer );
2216
2217 done:
2218     SetLastError( err );  /* restore last error code */
2219     return ret;
2220 }
2221
2222
2223 /******************************************************************************
2224  * RegSaveKeyA  [ADVAPI32.@]
2225  *
2226  * See RegSaveKeyW.
2227  */
2228 LSTATUS WINAPI RegSaveKeyA( HKEY hkey, LPCSTR file, LPSECURITY_ATTRIBUTES sa )
2229 {
2230     UNICODE_STRING *fileW = &NtCurrentTeb()->StaticUnicodeString;
2231     NTSTATUS status;
2232     STRING fileA;
2233
2234     RtlInitAnsiString(&fileA, file);
2235     if ((status = RtlAnsiStringToUnicodeString(fileW, &fileA, FALSE)))
2236         return RtlNtStatusToDosError( status );
2237     return RegSaveKeyW(hkey, fileW->Buffer, sa);
2238 }
2239
2240
2241 /******************************************************************************
2242  * RegRestoreKeyW [ADVAPI32.@]
2243  *
2244  * Read the registry information from a file and copy it over a key.
2245  *
2246  * PARAMS
2247  *  hkey    [I] Handle of key where restore begins
2248  *  lpFile  [I] Address of filename containing saved tree
2249  *  dwFlags [I] Optional flags
2250  *
2251  * RETURNS
2252  *  Success: ERROR_SUCCESS
2253  *  Failure: nonzero error code from Winerror.h
2254  */
2255 LSTATUS WINAPI RegRestoreKeyW( HKEY hkey, LPCWSTR lpFile, DWORD dwFlags )
2256 {
2257     TRACE("(%p,%s,%d)\n",hkey,debugstr_w(lpFile),dwFlags);
2258
2259     /* It seems to do this check before the hkey check */
2260     if (!lpFile || !*lpFile)
2261         return ERROR_INVALID_PARAMETER;
2262
2263     FIXME("(%p,%s,%d): stub\n",hkey,debugstr_w(lpFile),dwFlags);
2264
2265     /* Check for file existence */
2266
2267     return ERROR_SUCCESS;
2268 }
2269
2270
2271 /******************************************************************************
2272  * RegRestoreKeyA [ADVAPI32.@]
2273  *
2274  * See RegRestoreKeyW.
2275  */
2276 LSTATUS WINAPI RegRestoreKeyA( HKEY hkey, LPCSTR lpFile, DWORD dwFlags )
2277 {
2278     UNICODE_STRING lpFileW;
2279     LONG ret;
2280
2281     RtlCreateUnicodeStringFromAsciiz( &lpFileW, lpFile );
2282     ret = RegRestoreKeyW( hkey, lpFileW.Buffer, dwFlags );
2283     RtlFreeUnicodeString( &lpFileW );
2284     return ret;
2285 }
2286
2287
2288 /******************************************************************************
2289  * RegUnLoadKeyW [ADVAPI32.@]
2290  *
2291  * Unload a registry key and its subkeys from the registry.
2292  *
2293  * PARAMS
2294  *  hkey     [I] Handle of open key
2295  *  lpSubKey [I] Address of name of subkey to unload
2296  *
2297  * RETURNS
2298  *  Success: ERROR_SUCCESS
2299  *  Failure: nonzero error code from Winerror.h
2300  */
2301 LSTATUS WINAPI RegUnLoadKeyW( HKEY hkey, LPCWSTR lpSubKey )
2302 {
2303     DWORD ret;
2304     HKEY shkey;
2305     OBJECT_ATTRIBUTES attr;
2306     UNICODE_STRING subkey;
2307
2308     TRACE("(%p,%s)\n",hkey, debugstr_w(lpSubKey));
2309
2310     ret = RegOpenKeyW(hkey,lpSubKey,&shkey);
2311     if( ret )
2312         return ERROR_INVALID_PARAMETER;
2313
2314     RtlInitUnicodeString(&subkey, lpSubKey);
2315     InitializeObjectAttributes(&attr, &subkey, OBJ_CASE_INSENSITIVE, shkey, NULL);
2316     ret = RtlNtStatusToDosError(NtUnloadKey(&attr));
2317
2318     RegCloseKey(shkey);
2319
2320     return ret;
2321 }
2322
2323
2324 /******************************************************************************
2325  * RegUnLoadKeyA [ADVAPI32.@]
2326  *
2327  * See RegUnLoadKeyW.
2328  */
2329 LSTATUS WINAPI RegUnLoadKeyA( HKEY hkey, LPCSTR lpSubKey )
2330 {
2331     UNICODE_STRING lpSubKeyW;
2332     LONG ret;
2333
2334     RtlCreateUnicodeStringFromAsciiz( &lpSubKeyW, lpSubKey );
2335     ret = RegUnLoadKeyW( hkey, lpSubKeyW.Buffer );
2336     RtlFreeUnicodeString( &lpSubKeyW );
2337     return ret;
2338 }
2339
2340
2341 /******************************************************************************
2342  * RegReplaceKeyW [ADVAPI32.@]
2343  *
2344  * Replace the file backing a registry key and all its subkeys with another file.
2345  *
2346  * PARAMS
2347  *  hkey      [I] Handle of open key
2348  *  lpSubKey  [I] Address of name of subkey
2349  *  lpNewFile [I] Address of filename for file with new data
2350  *  lpOldFile [I] Address of filename for backup file
2351  *
2352  * RETURNS
2353  *  Success: ERROR_SUCCESS
2354  *  Failure: nonzero error code from Winerror.h
2355  */
2356 LSTATUS WINAPI RegReplaceKeyW( HKEY hkey, LPCWSTR lpSubKey, LPCWSTR lpNewFile,
2357                               LPCWSTR lpOldFile )
2358 {
2359     FIXME("(%p,%s,%s,%s): stub\n", hkey, debugstr_w(lpSubKey),
2360           debugstr_w(lpNewFile),debugstr_w(lpOldFile));
2361     return ERROR_SUCCESS;
2362 }
2363
2364
2365 /******************************************************************************
2366  * RegReplaceKeyA [ADVAPI32.@]
2367  *
2368  * See RegReplaceKeyW.
2369  */
2370 LSTATUS WINAPI RegReplaceKeyA( HKEY hkey, LPCSTR lpSubKey, LPCSTR lpNewFile,
2371                               LPCSTR lpOldFile )
2372 {
2373     UNICODE_STRING lpSubKeyW;
2374     UNICODE_STRING lpNewFileW;
2375     UNICODE_STRING lpOldFileW;
2376     LONG ret;
2377
2378     RtlCreateUnicodeStringFromAsciiz( &lpSubKeyW, lpSubKey );
2379     RtlCreateUnicodeStringFromAsciiz( &lpOldFileW, lpOldFile );
2380     RtlCreateUnicodeStringFromAsciiz( &lpNewFileW, lpNewFile );
2381     ret = RegReplaceKeyW( hkey, lpSubKeyW.Buffer, lpNewFileW.Buffer, lpOldFileW.Buffer );
2382     RtlFreeUnicodeString( &lpOldFileW );
2383     RtlFreeUnicodeString( &lpNewFileW );
2384     RtlFreeUnicodeString( &lpSubKeyW );
2385     return ret;
2386 }
2387
2388
2389 /******************************************************************************
2390  * RegSetKeySecurity [ADVAPI32.@]
2391  *
2392  * Set the security of an open registry key.
2393  *
2394  * PARAMS
2395  *  hkey          [I] Open handle of key to set
2396  *  SecurityInfo  [I] Descriptor contents
2397  *  pSecurityDesc [I] Address of descriptor for key
2398  *
2399  * RETURNS
2400  *  Success: ERROR_SUCCESS
2401  *  Failure: nonzero error code from Winerror.h
2402  */
2403 LSTATUS WINAPI RegSetKeySecurity( HKEY hkey, SECURITY_INFORMATION SecurityInfo,
2404                                PSECURITY_DESCRIPTOR pSecurityDesc )
2405 {
2406     TRACE("(%p,%d,%p)\n",hkey,SecurityInfo,pSecurityDesc);
2407
2408     /* It seems to perform this check before the hkey check */
2409     if ((SecurityInfo & OWNER_SECURITY_INFORMATION) ||
2410         (SecurityInfo & GROUP_SECURITY_INFORMATION) ||
2411         (SecurityInfo & DACL_SECURITY_INFORMATION) ||
2412         (SecurityInfo & SACL_SECURITY_INFORMATION)) {
2413         /* Param OK */
2414     } else
2415         return ERROR_INVALID_PARAMETER;
2416
2417     if (!pSecurityDesc)
2418         return ERROR_INVALID_PARAMETER;
2419
2420     FIXME(":(%p,%d,%p): stub\n",hkey,SecurityInfo,pSecurityDesc);
2421
2422     return ERROR_SUCCESS;
2423 }
2424
2425
2426 /******************************************************************************
2427  * RegGetKeySecurity [ADVAPI32.@]
2428  *
2429  * Get a copy of the security descriptor for a given registry key.
2430  *
2431  * PARAMS
2432  *  hkey                   [I]   Open handle of key to set
2433  *  SecurityInformation    [I]   Descriptor contents
2434  *  pSecurityDescriptor    [O]   Address of descriptor for key
2435  *  lpcbSecurityDescriptor [I/O] Address of size of buffer and description
2436  *
2437  * RETURNS
2438  *  Success: ERROR_SUCCESS
2439  *  Failure: Error code
2440  */
2441 LSTATUS WINAPI RegGetKeySecurity( HKEY hkey, SECURITY_INFORMATION SecurityInformation,
2442                                PSECURITY_DESCRIPTOR pSecurityDescriptor,
2443                                LPDWORD lpcbSecurityDescriptor )
2444 {
2445     TRACE("(%p,%d,%p,%d)\n",hkey,SecurityInformation,pSecurityDescriptor,
2446           *lpcbSecurityDescriptor);
2447
2448     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
2449
2450     return RtlNtStatusToDosError( NtQuerySecurityObject( hkey,
2451                 SecurityInformation, pSecurityDescriptor,
2452                 *lpcbSecurityDescriptor, lpcbSecurityDescriptor ) );
2453 }
2454
2455
2456 /******************************************************************************
2457  * RegFlushKey [ADVAPI32.@]
2458  *
2459  * Immediately write a registry key to registry.
2460  *
2461  * PARAMS
2462  *  hkey [I] Handle of key to write
2463  *
2464  * RETURNS
2465  *  Success: ERROR_SUCCESS
2466  *  Failure: Error code
2467  */
2468 LSTATUS WINAPI RegFlushKey( HKEY hkey )
2469 {
2470     hkey = get_special_root_hkey( hkey );
2471     if (!hkey) return ERROR_INVALID_HANDLE;
2472
2473     return RtlNtStatusToDosError( NtFlushKey( hkey ) );
2474 }
2475
2476
2477 /******************************************************************************
2478  * RegConnectRegistryW [ADVAPI32.@]
2479  *
2480  * Establish a connection to a predefined registry key on another computer.
2481  *
2482  * PARAMS
2483  *  lpMachineName [I] Address of name of remote computer
2484  *  hHey          [I] Predefined registry handle
2485  *  phkResult     [I] Address of buffer for remote registry handle
2486  *
2487  * RETURNS
2488  *  Success: ERROR_SUCCESS
2489  *  Failure: nonzero error code from Winerror.h
2490  */
2491 LSTATUS WINAPI RegConnectRegistryW( LPCWSTR lpMachineName, HKEY hKey,
2492                                    PHKEY phkResult )
2493 {
2494     LONG ret;
2495
2496     TRACE("(%s,%p,%p)\n",debugstr_w(lpMachineName), hKey, phkResult);
2497
2498     if (!lpMachineName || !*lpMachineName) {
2499         /* Use the local machine name */
2500         ret = RegOpenKeyW( hKey, NULL, phkResult );
2501     }
2502     else {
2503         WCHAR compName[MAX_COMPUTERNAME_LENGTH + 1];
2504         DWORD len = sizeof(compName) / sizeof(WCHAR);
2505
2506         /* MSDN says lpMachineName must start with \\ : not so */
2507         if( lpMachineName[0] == '\\' &&  lpMachineName[1] == '\\')
2508             lpMachineName += 2;
2509         if (GetComputerNameW(compName, &len))
2510         {
2511             if (!strcmpiW(lpMachineName, compName))
2512                 ret = RegOpenKeyW(hKey, NULL, phkResult);
2513             else
2514             {
2515                 FIXME("Connect to %s is not supported.\n",debugstr_w(lpMachineName));
2516                 ret = ERROR_BAD_NETPATH;
2517             }
2518         }
2519         else
2520             ret = GetLastError();
2521     }
2522     return ret;
2523 }
2524
2525
2526 /******************************************************************************
2527  * RegConnectRegistryA [ADVAPI32.@]
2528  *
2529  * See RegConnectRegistryW.
2530  */
2531 LSTATUS WINAPI RegConnectRegistryA( LPCSTR machine, HKEY hkey, PHKEY reskey )
2532 {
2533     UNICODE_STRING machineW;
2534     LONG ret;
2535
2536     RtlCreateUnicodeStringFromAsciiz( &machineW, machine );
2537     ret = RegConnectRegistryW( machineW.Buffer, hkey, reskey );
2538     RtlFreeUnicodeString( &machineW );
2539     return ret;
2540 }
2541
2542
2543 /******************************************************************************
2544  * RegNotifyChangeKeyValue [ADVAPI32.@]
2545  *
2546  * Notify the caller about changes to the attributes or contents of a registry key.
2547  *
2548  * PARAMS
2549  *  hkey            [I] Handle of key to watch
2550  *  fWatchSubTree   [I] Flag for subkey notification
2551  *  fdwNotifyFilter [I] Changes to be reported
2552  *  hEvent          [I] Handle of signaled event
2553  *  fAsync          [I] Flag for asynchronous reporting
2554  *
2555  * RETURNS
2556  *  Success: ERROR_SUCCESS
2557  *  Failure: nonzero error code from Winerror.h
2558  */
2559 LSTATUS WINAPI RegNotifyChangeKeyValue( HKEY hkey, BOOL fWatchSubTree,
2560                                      DWORD fdwNotifyFilter, HANDLE hEvent,
2561                                      BOOL fAsync )
2562 {
2563     NTSTATUS status;
2564     IO_STATUS_BLOCK iosb;
2565
2566     hkey = get_special_root_hkey( hkey );
2567     if (!hkey) return ERROR_INVALID_HANDLE;
2568
2569     TRACE("(%p,%i,%d,%p,%i)\n", hkey, fWatchSubTree, fdwNotifyFilter,
2570           hEvent, fAsync);
2571
2572     status = NtNotifyChangeKey( hkey, hEvent, NULL, NULL, &iosb,
2573                                 fdwNotifyFilter, fAsync, NULL, 0,
2574                                 fWatchSubTree);
2575
2576     if (status && status != STATUS_TIMEOUT)
2577         return RtlNtStatusToDosError( status );
2578
2579     return ERROR_SUCCESS;
2580 }
2581
2582 /******************************************************************************
2583  * RegOpenUserClassesRoot [ADVAPI32.@]
2584  *
2585  * Open the HKEY_CLASSES_ROOT key for a user.
2586  *
2587  * PARAMS
2588  *  hToken     [I] Handle of token representing the user
2589  *  dwOptions  [I] Reserved, must be 0
2590  *  samDesired [I] Desired access rights
2591  *  phkResult  [O] Destination for the resulting key handle
2592  *
2593  * RETURNS
2594  *  Success: ERROR_SUCCESS
2595  *  Failure: nonzero error code from Winerror.h
2596  *
2597  * NOTES
2598  *  On Windows 2000 and upwards the HKEY_CLASSES_ROOT key is a view of the
2599  *  "HKEY_LOCAL_MACHINE\Software\Classes" and the
2600  *  "HKEY_CURRENT_USER\Software\Classes" keys merged together.
2601  */
2602 LSTATUS WINAPI RegOpenUserClassesRoot(
2603     HANDLE hToken,
2604     DWORD dwOptions,
2605     REGSAM samDesired,
2606     PHKEY phkResult
2607 )
2608 {
2609     FIXME("(%p, 0x%x, 0x%x, %p) semi-stub\n", hToken, dwOptions, samDesired, phkResult);
2610
2611     *phkResult = HKEY_CLASSES_ROOT;
2612     return ERROR_SUCCESS;
2613 }
2614
2615 /******************************************************************************
2616  * load_string [Internal]
2617  *
2618  * This is basically a copy of user32/resource.c's LoadStringW. Necessary to
2619  * avoid importing user32, which is higher level than advapi32. Helper for
2620  * RegLoadMUIString.
2621  */
2622 static int load_string(HINSTANCE hModule, UINT resId, LPWSTR pwszBuffer, INT cMaxChars)
2623 {
2624     HGLOBAL hMemory;
2625     HRSRC hResource;
2626     WCHAR *pString;
2627     int idxString;
2628
2629     /* Negative values have to be inverted. */
2630     if (HIWORD(resId) == 0xffff)
2631         resId = (UINT)(-((INT)resId));
2632
2633     /* Load the resource into memory and get a pointer to it. */
2634     hResource = FindResourceW(hModule, MAKEINTRESOURCEW(LOWORD(resId >> 4) + 1), (LPWSTR)RT_STRING);
2635     if (!hResource) return 0;
2636     hMemory = LoadResource(hModule, hResource);
2637     if (!hMemory) return 0;
2638     pString = LockResource(hMemory);
2639
2640     /* Strings are length-prefixed. Lowest nibble of resId is an index. */
2641     idxString = resId & 0xf;
2642     while (idxString--) pString += *pString + 1;
2643
2644     /* If no buffer is given, return length of the string. */
2645     if (!pwszBuffer) return *pString;
2646
2647     /* Else copy over the string, respecting the buffer size. */
2648     cMaxChars = (*pString < cMaxChars) ? *pString : (cMaxChars - 1);
2649     if (cMaxChars >= 0) {
2650         memcpy(pwszBuffer, pString+1, cMaxChars * sizeof(WCHAR));
2651         pwszBuffer[cMaxChars] = '\0';
2652     }
2653
2654     return cMaxChars;
2655 }
2656
2657 /******************************************************************************
2658  * RegLoadMUIStringW [ADVAPI32.@]
2659  *
2660  * Load the localized version of a string resource from some PE, respective
2661  * id and path of which are given in the registry value in the format
2662  * @[path]\dllname,-resourceId
2663  *
2664  * PARAMS
2665  *  hKey       [I] Key, of which to load the string value from.
2666  *  pszValue   [I] The value to be loaded (Has to be of REG_EXPAND_SZ or REG_SZ type).
2667  *  pszBuffer  [O] Buffer to store the localized string in.
2668  *  cbBuffer   [I] Size of the destination buffer in bytes.
2669  *  pcbData    [O] Number of bytes written to pszBuffer (optional, may be NULL).
2670  *  dwFlags    [I] None supported yet.
2671  *  pszBaseDir [I] Not supported yet.
2672  *
2673  * RETURNS
2674  *  Success: ERROR_SUCCESS,
2675  *  Failure: nonzero error code from winerror.h
2676  *
2677  * NOTES
2678  *  This is an API of Windows Vista, which wasn't available at the time this code
2679  *  was written. We have to check for the correct behaviour once it's available.
2680  */
2681 LSTATUS WINAPI RegLoadMUIStringW(HKEY hKey, LPCWSTR pwszValue, LPWSTR pwszBuffer, DWORD cbBuffer,
2682     LPDWORD pcbData, DWORD dwFlags, LPCWSTR pwszBaseDir)
2683 {
2684     DWORD dwValueType, cbData;
2685     LPWSTR pwszTempBuffer = NULL, pwszExpandedBuffer = NULL;
2686     LONG result;
2687
2688     TRACE("(hKey = %p, pwszValue = %s, pwszBuffer = %p, cbBuffer = %d, pcbData = %p, "
2689           "dwFlags = %d, pwszBaseDir = %s)\n", hKey, debugstr_w(pwszValue), pwszBuffer,
2690           cbBuffer, pcbData, dwFlags, debugstr_w(pwszBaseDir));
2691
2692     /* Parameter sanity checks. */
2693     if (!hKey || !pwszBuffer)
2694         return ERROR_INVALID_PARAMETER;
2695
2696     if (pwszBaseDir && *pwszBaseDir) {
2697         FIXME("BaseDir parameter not yet supported!\n");
2698         return ERROR_INVALID_PARAMETER;
2699     }
2700
2701     /* Check for value existence and correctness of it's type, allocate a buffer and load it. */
2702     result = RegQueryValueExW(hKey, pwszValue, NULL, &dwValueType, NULL, &cbData);
2703     if (result != ERROR_SUCCESS) goto cleanup;
2704     if (!(dwValueType == REG_SZ || dwValueType == REG_EXPAND_SZ) || !cbData) {
2705         result = ERROR_FILE_NOT_FOUND;
2706         goto cleanup;
2707     }
2708     pwszTempBuffer = HeapAlloc(GetProcessHeap(), 0, cbData);
2709     if (!pwszTempBuffer) {
2710         result = ERROR_NOT_ENOUGH_MEMORY;
2711         goto cleanup;
2712     }
2713     result = RegQueryValueExW(hKey, pwszValue, NULL, &dwValueType, (LPBYTE)pwszTempBuffer, &cbData);
2714     if (result != ERROR_SUCCESS) goto cleanup;
2715
2716     /* Expand environment variables, if appropriate, or copy the original string over. */
2717     if (dwValueType == REG_EXPAND_SZ) {
2718         cbData = ExpandEnvironmentStringsW(pwszTempBuffer, NULL, 0) * sizeof(WCHAR);
2719         if (!cbData) goto cleanup;
2720         pwszExpandedBuffer = HeapAlloc(GetProcessHeap(), 0, cbData);
2721         if (!pwszExpandedBuffer) {
2722             result = ERROR_NOT_ENOUGH_MEMORY;
2723             goto cleanup;
2724         }
2725         ExpandEnvironmentStringsW(pwszTempBuffer, pwszExpandedBuffer, cbData);
2726     } else {
2727         pwszExpandedBuffer = HeapAlloc(GetProcessHeap(), 0, cbData);
2728         memcpy(pwszExpandedBuffer, pwszTempBuffer, cbData);
2729     }
2730
2731     /* If the value references a resource based string, parse the value and load the string.
2732      * Else just copy over the original value. */
2733     result = ERROR_SUCCESS;
2734     if (*pwszExpandedBuffer != '@') { /* '@' is the prefix for resource based string entries. */
2735         lstrcpynW(pwszBuffer, pwszExpandedBuffer, cbBuffer / sizeof(WCHAR));
2736     } else {
2737         WCHAR *pComma = strrchrW(pwszExpandedBuffer, ',');
2738         UINT uiStringId;
2739         HMODULE hModule;
2740
2741         /* Format of the expanded value is 'path_to_dll,-resId' */
2742         if (!pComma || pComma[1] != '-') {
2743             result = ERROR_BADKEY;
2744             goto cleanup;
2745         }
2746
2747         uiStringId = atoiW(pComma+2);
2748         *pComma = '\0';
2749
2750         hModule = LoadLibraryW(pwszExpandedBuffer + 1);
2751         if (!hModule || !load_string(hModule, uiStringId, pwszBuffer, cbBuffer/sizeof(WCHAR)))
2752             result = ERROR_BADKEY;
2753         FreeLibrary(hModule);
2754     }
2755
2756 cleanup:
2757     HeapFree(GetProcessHeap(), 0, pwszTempBuffer);
2758     HeapFree(GetProcessHeap(), 0, pwszExpandedBuffer);
2759     return result;
2760 }
2761
2762 /******************************************************************************
2763  * RegLoadMUIStringA [ADVAPI32.@]
2764  *
2765  * See RegLoadMUIStringW
2766  */
2767 LSTATUS WINAPI RegLoadMUIStringA(HKEY hKey, LPCSTR pszValue, LPSTR pszBuffer, DWORD cbBuffer,
2768     LPDWORD pcbData, DWORD dwFlags, LPCSTR pszBaseDir)
2769 {
2770     UNICODE_STRING valueW, baseDirW;
2771     WCHAR *pwszBuffer;
2772     DWORD cbData = cbBuffer * sizeof(WCHAR);
2773     LONG result;
2774
2775     valueW.Buffer = baseDirW.Buffer = pwszBuffer = NULL;
2776     if (!RtlCreateUnicodeStringFromAsciiz(&valueW, pszValue) ||
2777         !RtlCreateUnicodeStringFromAsciiz(&baseDirW, pszBaseDir) ||
2778         !(pwszBuffer = HeapAlloc(GetProcessHeap(), 0, cbData)))
2779     {
2780         result = ERROR_NOT_ENOUGH_MEMORY;
2781         goto cleanup;
2782     }
2783
2784     result = RegLoadMUIStringW(hKey, valueW.Buffer, pwszBuffer, cbData, NULL, dwFlags,
2785                                baseDirW.Buffer);
2786
2787     if (result == ERROR_SUCCESS) {
2788         cbData = WideCharToMultiByte(CP_ACP, 0, pwszBuffer, -1, pszBuffer, cbBuffer, NULL, NULL);
2789         if (pcbData)
2790             *pcbData = cbData;
2791     }
2792
2793 cleanup:
2794     HeapFree(GetProcessHeap(), 0, pwszBuffer);
2795     RtlFreeUnicodeString(&baseDirW);
2796     RtlFreeUnicodeString(&valueW);
2797
2798     return result;
2799 }
2800
2801 /******************************************************************************
2802  * RegDisablePredefinedCache [ADVAPI32.@]
2803  *
2804  * Disables the caching of the HKEY_CLASSES_ROOT key for the process.
2805  *
2806  * PARAMS
2807  *  None.
2808  *
2809  * RETURNS
2810  *  Success: ERROR_SUCCESS
2811  *  Failure: nonzero error code from Winerror.h
2812  *
2813  * NOTES
2814  *  This is useful for services that use impersonation.
2815  */
2816 LSTATUS WINAPI RegDisablePredefinedCache(void)
2817 {
2818     HKEY hkey_current_user;
2819     int idx = HandleToUlong(HKEY_CURRENT_USER) - HandleToUlong(HKEY_SPECIAL_ROOT_FIRST);
2820
2821     /* prevent caching of future requests */
2822     hkcu_cache_disabled = TRUE;
2823
2824     hkey_current_user = InterlockedExchangePointer( (void **)&special_root_keys[idx], NULL );
2825
2826     if (hkey_current_user)
2827         NtClose( hkey_current_user );
2828
2829     return ERROR_SUCCESS;
2830 }
2831
2832 /******************************************************************************
2833  * RegDeleteTreeW [ADVAPI32.@]
2834  *
2835  */
2836 LSTATUS WINAPI RegDeleteTreeW(HKEY hKey, LPCWSTR lpszSubKey)
2837 {
2838     LONG ret;
2839     DWORD dwMaxSubkeyLen, dwMaxValueLen;
2840     DWORD dwMaxLen, dwSize;
2841     WCHAR szNameBuf[MAX_PATH], *lpszName = szNameBuf;
2842     HKEY hSubKey = hKey;
2843
2844     TRACE("(hkey=%p,%p %s)\n", hKey, lpszSubKey, debugstr_w(lpszSubKey));
2845
2846     if(lpszSubKey)
2847     {
2848         ret = RegOpenKeyExW(hKey, lpszSubKey, 0, KEY_READ, &hSubKey);
2849         if (ret) return ret;
2850     }
2851
2852     /* Get highest length for keys, values */
2853     ret = RegQueryInfoKeyW(hSubKey, NULL, NULL, NULL, NULL,
2854             &dwMaxSubkeyLen, NULL, NULL, &dwMaxValueLen, NULL, NULL, NULL);
2855     if (ret) goto cleanup;
2856
2857     dwMaxSubkeyLen++;
2858     dwMaxValueLen++;
2859     dwMaxLen = max(dwMaxSubkeyLen, dwMaxValueLen);
2860     if (dwMaxLen > sizeof(szNameBuf)/sizeof(WCHAR))
2861     {
2862         /* Name too big: alloc a buffer for it */
2863         if (!(lpszName = HeapAlloc( GetProcessHeap(), 0, dwMaxLen*sizeof(WCHAR))))
2864         {
2865             ret = ERROR_NOT_ENOUGH_MEMORY;
2866             goto cleanup;
2867         }
2868     }
2869
2870
2871     /* Recursively delete all the subkeys */
2872     while (TRUE)
2873     {
2874         dwSize = dwMaxLen;
2875         if (RegEnumKeyExW(hSubKey, 0, lpszName, &dwSize, NULL,
2876                           NULL, NULL, NULL)) break;
2877
2878         ret = RegDeleteTreeW(hSubKey, lpszName);
2879         if (ret) goto cleanup;
2880     }
2881
2882     if (lpszSubKey)
2883         ret = RegDeleteKeyW(hKey, lpszSubKey);
2884     else
2885         while (TRUE)
2886         {
2887             dwSize = dwMaxLen;
2888             if (RegEnumValueW(hKey, 0, lpszName, &dwSize,
2889                   NULL, NULL, NULL, NULL)) break;
2890
2891             ret = RegDeleteValueW(hKey, lpszName);
2892             if (ret) goto cleanup;
2893         }
2894
2895 cleanup:
2896     /* Free buffer if allocated */
2897     if (lpszName != szNameBuf)
2898         HeapFree( GetProcessHeap(), 0, lpszName);
2899     if(lpszSubKey)
2900         RegCloseKey(hSubKey);
2901     return ret;
2902 }
2903
2904 /******************************************************************************
2905  * RegDeleteTreeA [ADVAPI32.@]
2906  *
2907  */
2908 LSTATUS WINAPI RegDeleteTreeA(HKEY hKey, LPCSTR lpszSubKey)
2909 {
2910     LONG ret;
2911     UNICODE_STRING lpszSubKeyW;
2912
2913     if (lpszSubKey) RtlCreateUnicodeStringFromAsciiz( &lpszSubKeyW, lpszSubKey);
2914     else lpszSubKeyW.Buffer = NULL;
2915     ret = RegDeleteTreeW( hKey, lpszSubKeyW.Buffer);
2916     RtlFreeUnicodeString( &lpszSubKeyW );
2917     return ret;
2918 }
2919
2920 /******************************************************************************
2921  * RegDisableReflectionKey [ADVAPI32.@]
2922  *
2923  */
2924 LONG WINAPI RegDisableReflectionKey(HKEY base)
2925 {
2926     FIXME("%p: stub\n", base);
2927     return ERROR_SUCCESS;
2928 }