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 file is concerned about handle management and interaction with the Wine server.
  12  * Registry file I/O is in misc/registry.c.
  13  *
  14  * This library is free software; you can redistribute it and/or
  15  * modify it under the terms of the GNU Lesser General Public
  16  * License as published by the Free Software Foundation; either
  17  * version 2.1 of the License, or (at your option) any later version.
  18  *
  19  * This library is distributed in the hope that it will be useful,
  20  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  21  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  22  * Lesser General Public License for more details.
  23  *
  24  * You should have received a copy of the GNU Lesser General Public
  25  * License along with this library; if not, write to the Free Software
  26  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  27  */
  28
  29 #include <stdlib.h>
  30 #include <stdarg.h>
  31 #include <stdio.h>
  32
  33 #include "windef.h"
  34 #include "winbase.h"
  35 #include "winreg.h"
  36 #include "winerror.h"
  37 #include "ntstatus.h"
  38 #include "winternl.h"
  39
  40 #include "wine/unicode.h"
  41 #include "wine/debug.h"
  42
  43 WINE_DEFAULT_DEBUG_CHANNEL(reg);
  44
  45 /* allowed bits for access mask */
  46 #define KEY_ACCESS_MASK (KEY_ALL_ACCESS | MAXIMUM_ALLOWED)
  47
  48 #define HKEY_SPECIAL_ROOT_FIRST   HKEY_CLASSES_ROOT
  49 #define HKEY_SPECIAL_ROOT_LAST    HKEY_DYN_DATA
  50 #define NB_SPECIAL_ROOT_KEYS      ((UINT)HKEY_SPECIAL_ROOT_LAST - (UINT)HKEY_SPECIAL_ROOT_FIRST + 1)
  51
  52 static HKEY special_root_keys[NB_SPECIAL_ROOT_KEYS];
  53
  54 static const WCHAR name_CLASSES_ROOT[] =
  55     {'M','a','c','h','i','n','e','\\',
  56      'S','o','f','t','w','a','r','e','\\',
  57      'C','l','a','s','s','e','s',0};
  58 static const WCHAR name_LOCAL_MACHINE[] =
  59     {'M','a','c','h','i','n','e',0};
  60 static const WCHAR name_USERS[] =
  61     {'U','s','e','r',0};
  62 static const WCHAR name_PERFORMANCE_DATA[] =
  63     {'P','e','r','f','D','a','t','a',0};
  64 static const WCHAR name_CURRENT_CONFIG[] =
  65     {'M','a','c','h','i','n','e','\\',
  66      'S','y','s','t','e','m','\\',
  67      'C','u','r','r','e','n','t','C','o','n','t','r','o','l','S','e','t','\\',
  68      'H','a','r','d','w','a','r','e',' ','P','r','o','f','i','l','e','s','\\',
  69      'C','u','r','r','e','n','t',0};
  70 static const WCHAR name_DYN_DATA[] =
  71     {'D','y','n','D','a','t','a',0};
  72
  73 #define DECL_STR(key) { sizeof(name_##key)-sizeof(WCHAR), sizeof(name_##key), (LPWSTR)name_##key }
  74 static UNICODE_STRING root_key_names[NB_SPECIAL_ROOT_KEYS] =
  75 {
  76     DECL_STR(CLASSES_ROOT),
  77     { 0, 0, NULL },         /* HKEY_CURRENT_USER is determined dynamically */
  78     DECL_STR(LOCAL_MACHINE),
  79     DECL_STR(USERS),
  80     DECL_STR(PERFORMANCE_DATA),
  81     DECL_STR(CURRENT_CONFIG),
  82     DECL_STR(DYN_DATA)
  83 };
  84 #undef DECL_STR
  85
  86
  87 /* check if value type needs string conversion (Ansi<->Unicode) */
  88 inline static int is_string( DWORD type )
  89 {
  90     return (type == REG_SZ) || (type == REG_EXPAND_SZ) || (type == REG_MULTI_SZ);
  91 }
  92
  93 /* check if current version is NT or Win95 */
  94 inline static int is_version_nt(void)
  95 {
  96     return !(GetVersion() & 0x80000000);
  97 }
  98
  99 /* create one of the HKEY_* special root keys */
 100 static HKEY create_special_root_hkey( HANDLE hkey, DWORD access )
 101 {
 102     HKEY ret = 0;
 103     int idx = (UINT)hkey - (UINT)HKEY_SPECIAL_ROOT_FIRST;
 104
 105     if (hkey == HKEY_CURRENT_USER)
 106     {
 107         if (RtlOpenCurrentUser( access, &hkey )) return 0;
 108         TRACE( "HKEY_CURRENT_USER -> %p\n", hkey );
 109     }
 110     else
 111     {
 112         OBJECT_ATTRIBUTES attr;
 113
 114         attr.Length = sizeof(attr);
 115         attr.RootDirectory = 0;
 116         attr.ObjectName = &root_key_names[idx];
 117         attr.Attributes = 0;
 118         attr.SecurityDescriptor = NULL;
 119         attr.SecurityQualityOfService = NULL;
 120         if (NtCreateKey( &hkey, access, &attr, 0, NULL, 0, NULL )) return 0;
 121         TRACE( "%s -> %p\n", debugstr_w(attr.ObjectName->Buffer), hkey );
 122     }
 123
 124     if (!(ret = InterlockedCompareExchangePointer( (void **)&special_root_keys[idx], hkey, 0 )))
 125         ret = hkey;
 126     else
 127         NtClose( hkey );  /* somebody beat us to it */
 128     return ret;
 129 }
 130
 131 /* map the hkey from special root to normal key if necessary */
 132 inline static HKEY get_special_root_hkey( HKEY hkey )
 133 {
 134     HKEY ret = hkey;
 135
 136     if ((hkey >= HKEY_SPECIAL_ROOT_FIRST) && (hkey <= HKEY_SPECIAL_ROOT_LAST))
 137     {
 138         if (!(ret = special_root_keys[(UINT)hkey - (UINT)HKEY_SPECIAL_ROOT_FIRST]))
 139             ret = create_special_root_hkey( hkey, KEY_ALL_ACCESS );
 140     }
 141     return ret;
 142 }
 143
 144
 145 /******************************************************************************
 146  * RegCreateKeyExW   [ADVAPI32.@]
 147  *
 148  * See RegCreateKeyExA.
 149  */
 150 DWORD WINAPI RegCreateKeyExW( HKEY hkey, LPCWSTR name, DWORD reserved, LPWSTR class,
 151                               DWORD options, REGSAM access, SECURITY_ATTRIBUTES *sa,
 152                               PHKEY retkey, LPDWORD dispos )
 153 {
 154     OBJECT_ATTRIBUTES attr;
 155     UNICODE_STRING nameW, classW;
 156
 157     if (reserved) return ERROR_INVALID_PARAMETER;
 158     if (!(access & KEY_ACCESS_MASK) || (access & ~KEY_ACCESS_MASK)) return ERROR_ACCESS_DENIED;
 159     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
 160
 161     attr.Length = sizeof(attr);
 162     attr.RootDirectory = hkey;
 163     attr.ObjectName = &nameW;
 164     attr.Attributes = 0;
 165     attr.SecurityDescriptor = NULL;
 166     attr.SecurityQualityOfService = NULL;
 167     RtlInitUnicodeString( &nameW, name );
 168     RtlInitUnicodeString( &classW, class );
 169
 170     return RtlNtStatusToDosError( NtCreateKey( (PHANDLE)retkey, access, &attr, 0,
 171                                                &classW, options, dispos ) );
 172 }
 173
 174
 175 /******************************************************************************
 176  * RegCreateKeyExA   [ADVAPI32.@]
 177  *
 178  * Open a registry key, creating it if it doesn't exist.
 179  *
 180  * PARAMS
 181  *  hkey       [I] Handle of the parent registry key
 182  *  name       [I] Name of the new key to open or create
 183  *  reserved   [I] Reserved, pass 0
 184  *  class      [I] The object type of the new key
 185  *  options    [I] Flags controlling the key creation (REG_OPTION_* flags from "winnt.h")
 186  *  access     [I] Access level desired
 187  *  sa         [I] Security attributes for the key
 188  *  retkey     [O] Destination for the resulting handle
 189  *  dispos     [O] Receives REG_CREATED_NEW_KEY or REG_OPENED_EXISTING_KEY
 190  *
 191  * RETURNS
 192  *  Success: ERROR_SUCCESS.
 193  *  Failure: A standard Win32 error code. retkey remains untouched.
 194  *
 195  * FIXME
 196  *  MAXIMUM_ALLOWED in access mask not supported by server
 197  */
 198 DWORD WINAPI RegCreateKeyExA( HKEY hkey, LPCSTR name, DWORD reserved, LPSTR class,
 199                               DWORD options, REGSAM access, SECURITY_ATTRIBUTES *sa,
 200                               PHKEY retkey, LPDWORD dispos )
 201 {
 202     OBJECT_ATTRIBUTES attr;
 203     UNICODE_STRING classW;
 204     ANSI_STRING nameA, classA;
 205     NTSTATUS status;
 206
 207     if (reserved) return ERROR_INVALID_PARAMETER;
 208     if (!is_version_nt()) access = KEY_ALL_ACCESS;  /* Win95 ignores the access mask */
 209     else if (!(access & KEY_ACCESS_MASK) || (access & ~KEY_ACCESS_MASK)) return ERROR_ACCESS_DENIED;
 210     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
 211
 212     attr.Length = sizeof(attr);
 213     attr.RootDirectory = hkey;
 214     attr.ObjectName = &NtCurrentTeb()->StaticUnicodeString;
 215     attr.Attributes = 0;
 216     attr.SecurityDescriptor = NULL;
 217     attr.SecurityQualityOfService = NULL;
 218     RtlInitAnsiString( &nameA, name );
 219     RtlInitAnsiString( &classA, class );
 220
 221     if (!(status = RtlAnsiStringToUnicodeString( &NtCurrentTeb()->StaticUnicodeString,
 222                                                  &nameA, FALSE )))
 223     {
 224         if (!(status = RtlAnsiStringToUnicodeString( &classW, &classA, TRUE )))
 225         {
 226             status = NtCreateKey( (PHANDLE)retkey, access, &attr, 0, &classW, options, dispos );
 227             RtlFreeUnicodeString( &classW );
 228         }
 229     }
 230     return RtlNtStatusToDosError( status );
 231 }
 232
 233
 234 /******************************************************************************
 235  * RegCreateKeyW   [ADVAPI32.@]
 236  *
 237  * Creates the specified reg key.
 238  *
 239  * PARAMS
 240  *  hKey      [I] Handle to an open key.
 241  *  lpSubKey  [I] Name of a key that will be opened or created.
 242  *  phkResult [O] Receives a handle to the opened or created key.
 243  *
 244  * RETURNS
 245  *  Success: ERROR_SUCCESS
 246  *  Failure: nonzero error code defined in Winerror.h
 247  */
 248 DWORD WINAPI RegCreateKeyW( HKEY hkey, LPCWSTR lpSubKey, PHKEY phkResult )
 249 {
 250     /* FIXME: previous implementation converted ERROR_INVALID_HANDLE to ERROR_BADKEY, */
 251     /* but at least my version of NT (4.0 SP5) doesn't do this.  -- AJ */
 252     return RegCreateKeyExW( hkey, lpSubKey, 0, NULL, REG_OPTION_NON_VOLATILE,
 253                             KEY_ALL_ACCESS, NULL, phkResult, NULL );
 254 }
 255
 256
 257 /******************************************************************************
 258  * RegCreateKeyA   [ADVAPI32.@]
 259  *
 260  * see RegCreateKeyW
 261  */
 262 DWORD WINAPI RegCreateKeyA( HKEY hkey, LPCSTR lpSubKey, PHKEY phkResult )
 263 {
 264     return RegCreateKeyExA( hkey, lpSubKey, 0, NULL, REG_OPTION_NON_VOLATILE,
 265                             KEY_ALL_ACCESS, NULL, phkResult, NULL );
 266 }
 267
 268
 269
 270 /******************************************************************************
 271  * RegOpenKeyExW   [ADVAPI32.@]
 272  *
 273  * See RegOpenKeyExA.
 274  */
 275 DWORD WINAPI RegOpenKeyExW( HKEY hkey, LPCWSTR name, DWORD reserved, REGSAM access, PHKEY retkey )
 276 {
 277     OBJECT_ATTRIBUTES attr;
 278     UNICODE_STRING nameW;
 279
 280     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
 281
 282     attr.Length = sizeof(attr);
 283     attr.RootDirectory = hkey;
 284     attr.ObjectName = &nameW;
 285     attr.Attributes = 0;
 286     attr.SecurityDescriptor = NULL;
 287     attr.SecurityQualityOfService = NULL;
 288     RtlInitUnicodeString( &nameW, name );
 289     return RtlNtStatusToDosError( NtOpenKey( (PHANDLE)retkey, access, &attr ) );
 290 }
 291
 292
 293 /******************************************************************************
 294  * RegOpenKeyExA   [ADVAPI32.@]
 295  *
 296  * Open a registry key.
 297  *
 298  * PARAMS
 299  *  hkey       [I] Handle of open key
 300  *  name       [I] Name of subkey to open
 301  *  reserved   [I] Reserved - must be zero
 302  *  access     [I] Security access mask
 303  *  retkey     [O] Handle to open key
 304  *
 305  * RETURNS
 306  *  Success: ERROR_SUCCESS
 307  *  Failure: A standard Win32 error code. retkey is set to 0.
 308  *
 309  * NOTES
 310  *  Unlike RegCreateKeyExA(), this function will not create the key if it
 311  *  does not exist.
 312  */
 313 DWORD WINAPI RegOpenKeyExA( HKEY hkey, LPCSTR name, DWORD reserved, REGSAM access, PHKEY retkey )
 314 {
 315     OBJECT_ATTRIBUTES attr;
 316     STRING nameA;
 317     NTSTATUS status;
 318
 319     if (!is_version_nt()) access = KEY_ALL_ACCESS;  /* Win95 ignores the access mask */
 320
 321     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
 322
 323     attr.Length = sizeof(attr);
 324     attr.RootDirectory = hkey;
 325     attr.ObjectName = &NtCurrentTeb()->StaticUnicodeString;
 326     attr.Attributes = 0;
 327     attr.SecurityDescriptor = NULL;
 328     attr.SecurityQualityOfService = NULL;
 329
 330     RtlInitAnsiString( &nameA, name );
 331     if (!(status = RtlAnsiStringToUnicodeString( &NtCurrentTeb()->StaticUnicodeString,
 332                                                  &nameA, FALSE )))
 333     {
 334         status = NtOpenKey( (PHANDLE)retkey, access, &attr );
 335     }
 336     return RtlNtStatusToDosError( status );
 337 }
 338
 339
 340 /******************************************************************************
 341  * RegOpenKeyW   [ADVAPI32.@]
 342  *
 343  * See RegOpenKeyA.
 344  */
 345 DWORD WINAPI RegOpenKeyW( HKEY hkey, LPCWSTR name, PHKEY retkey )
 346 {
 347     if (!name || !*name)
 348     {
 349         *retkey = hkey;
 350         return ERROR_SUCCESS;
 351     }
 352     return RegOpenKeyExW( hkey, name, 0, KEY_ALL_ACCESS, retkey );
 353 }
 354
 355
 356 /******************************************************************************
 357  * RegOpenKeyA   [ADVAPI32.@]
 358  *
 359  * Open a registry key.
 360  *
 361  * PARAMS
 362  *  hkey    [I] Handle of parent key to open the new key under
 363  *  name    [I] Name of the key under hkey to open
 364  *  retkey  [O] Destination for the resulting Handle
 365  *
 366  * RETURNS
 367  *  Success: ERROR_SUCCESS
 368  *  Failure: A standard Win32 error code. retkey is set to 0.
 369  */
 370 DWORD WINAPI RegOpenKeyA( HKEY hkey, LPCSTR name, PHKEY retkey )
 371 {
 372     if (!name || !*name)
 373     {
 374         *retkey = hkey;
 375         return ERROR_SUCCESS;
 376     }
 377     return RegOpenKeyExA( hkey, name, 0, KEY_ALL_ACCESS, retkey );
 378 }
 379
 380
 381 /******************************************************************************
 382  * RegOpenCurrentUser   [ADVAPI32.@]
 383  *
 384  * FIXME: This function is supposed to retrieve a handle to the
 385  * HKEY_CURRENT_USER for the user the current thread is impersonating.
 386  * Since Wine does not currently allow threads to impersonate other users,
 387  * this stub should work fine.
 388  */
 389 DWORD WINAPI RegOpenCurrentUser( REGSAM access, PHKEY retkey )
 390 {
 391     return RegOpenKeyExA( HKEY_CURRENT_USER, "", 0, access, retkey );
 392 }
 393
 394
 395
 396 /******************************************************************************
 397  * RegEnumKeyExW   [ADVAPI32.@]
 398  *
 399  * PARAMS
 400  *  hkey         [I] Handle to key to enumerate
 401  *  index        [I] Index of subkey to enumerate
 402  *  name         [O] Buffer for subkey name
 403  *  name_len     [O] Size of subkey buffer
 404  *  reserved     [I] Reserved
 405  *  class        [O] Buffer for class string
 406  *  class_len    [O] Size of class buffer
 407  *  ft           [O] Time key last written to
 408  *
 409  * RETURNS
 410  *  Success: ERROR_SUCCESS
 411  *  Failure: System error code. If there are no more subkeys available, the
 412  *           function returns ERROR_NO_MORE_ITEMS.
 413  */
 414 DWORD WINAPI RegEnumKeyExW( HKEY hkey, DWORD index, LPWSTR name, LPDWORD name_len,
 415                             LPDWORD reserved, LPWSTR class, LPDWORD class_len, FILETIME *ft )
 416 {
 417     NTSTATUS status;
 418     char buffer[256], *buf_ptr = buffer;
 419     KEY_NODE_INFORMATION *info = (KEY_NODE_INFORMATION *)buffer;
 420     DWORD total_size;
 421
 422     TRACE( "(%p,%ld,%p,%p(%ld),%p,%p,%p,%p)\n", hkey, index, name, name_len,
 423            name_len ? *name_len : -1, reserved, class, class_len, ft );
 424
 425     if (reserved) return ERROR_INVALID_PARAMETER;
 426     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
 427
 428     status = NtEnumerateKey( hkey, index, KeyNodeInformation,
 429                              buffer, sizeof(buffer), &total_size );
 430
 431     while (status == STATUS_BUFFER_OVERFLOW)
 432     {
 433         /* retry with a dynamically allocated buffer */
 434         if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
 435         if (!(buf_ptr = HeapAlloc( GetProcessHeap(), 0, total_size )))
 436             return ERROR_NOT_ENOUGH_MEMORY;
 437         info = (KEY_NODE_INFORMATION *)buf_ptr;
 438         status = NtEnumerateKey( hkey, index, KeyNodeInformation,
 439                                  buf_ptr, total_size, &total_size );
 440     }
 441
 442     if (!status)
 443     {
 444         DWORD len = info->NameLength / sizeof(WCHAR);
 445         DWORD cls_len = info->ClassLength / sizeof(WCHAR);
 446
 447         if (ft) *ft = *(FILETIME *)&info->LastWriteTime;
 448
 449         if (len >= *name_len || (class && class_len && (cls_len >= *class_len)))
 450             status = STATUS_BUFFER_OVERFLOW;
 451         else
 452         {
 453             *name_len = len;
 454             memcpy( name, info->Name, info->NameLength );
 455             name[len] = 0;
 456             if (class_len)
 457             {
 458                 *class_len = cls_len;
 459                 if (class)
 460                 {
 461                     memcpy( class, buf_ptr + info->ClassOffset, info->ClassLength );
 462                     class[cls_len] = 0;
 463                 }
 464             }
 465         }
 466     }
 467
 468     if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
 469     return RtlNtStatusToDosError( status );
 470 }
 471
 472
 473 /******************************************************************************
 474  * RegEnumKeyExA   [ADVAPI32.@]
 475  *
 476  * see RegEnumKeyExW
 477  */
 478 DWORD WINAPI RegEnumKeyExA( HKEY hkey, DWORD index, LPSTR name, LPDWORD name_len,
 479                             LPDWORD reserved, LPSTR class, LPDWORD class_len, FILETIME *ft )
 480 {
 481     NTSTATUS status;
 482     char buffer[256], *buf_ptr = buffer;
 483     KEY_NODE_INFORMATION *info = (KEY_NODE_INFORMATION *)buffer;
 484     DWORD total_size;
 485
 486     TRACE( "(%p,%ld,%p,%p(%ld),%p,%p,%p,%p)\n", hkey, index, name, name_len,
 487            name_len ? *name_len : -1, reserved, class, class_len, ft );
 488
 489     if (reserved) return ERROR_INVALID_PARAMETER;
 490     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
 491
 492     status = NtEnumerateKey( hkey, index, KeyNodeInformation,
 493                              buffer, sizeof(buffer), &total_size );
 494
 495     while (status == STATUS_BUFFER_OVERFLOW)
 496     {
 497         /* retry with a dynamically allocated buffer */
 498         if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
 499         if (!(buf_ptr = HeapAlloc( GetProcessHeap(), 0, total_size )))
 500             return ERROR_NOT_ENOUGH_MEMORY;
 501         info = (KEY_NODE_INFORMATION *)buf_ptr;
 502         status = NtEnumerateKey( hkey, index, KeyNodeInformation,
 503                                  buf_ptr, total_size, &total_size );
 504     }
 505
 506     if (!status)
 507     {
 508         DWORD len, cls_len;
 509
 510         RtlUnicodeToMultiByteSize( &len, info->Name, info->NameLength );
 511         RtlUnicodeToMultiByteSize( &cls_len, (WCHAR *)(buf_ptr + info->ClassOffset),
 512                                    info->ClassLength );
 513         if (ft) *ft = *(FILETIME *)&info->LastWriteTime;
 514
 515         if (len >= *name_len || (class && class_len && (cls_len >= *class_len)))
 516             status = STATUS_BUFFER_OVERFLOW;
 517         else
 518         {
 519             *name_len = len;
 520             RtlUnicodeToMultiByteN( name, len, NULL, info->Name, info->NameLength );
 521             name[len] = 0;
 522             if (class_len)
 523             {
 524                 *class_len = cls_len;
 525                 if (class)
 526                 {
 527                     RtlUnicodeToMultiByteN( class, cls_len, NULL,
 528                                             (WCHAR *)(buf_ptr + info->ClassOffset),
 529                                             info->ClassLength );
 530                     class[cls_len] = 0;
 531                 }
 532             }
 533         }
 534     }
 535
 536     if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
 537     return RtlNtStatusToDosError( status );
 538 }
 539
 540
 541 /******************************************************************************
 542  * RegEnumKeyW   [ADVAPI32.@]
 543  *
 544  * Enumerates subkyes of the specified open reg key.
 545  *
 546  * PARAMS
 547  *  hKey    [I] Handle to an open key.
 548  *  dwIndex [I] Index of the subkey of hKey to retrieve.
 549  *  lpName  [O] Name of the subkey.
 550  *  cchName [I] Size of lpName in TCHARS.
 551  *
 552  * RETURNS
 553  *  Success: ERROR_SUCCESS
 554  *  Failure: system error code. If there are no more subkeys available, the
 555  *           function returns ERROR_NO_MORE_ITEMS.
 556  */
 557 DWORD WINAPI RegEnumKeyW( HKEY hkey, DWORD index, LPWSTR name, DWORD name_len )
 558 {
 559     return RegEnumKeyExW( hkey, index, name, &name_len, NULL, NULL, NULL, NULL );
 560 }
 561
 562
 563 /******************************************************************************
 564  * RegEnumKeyA   [ADVAPI32.@]
 565  *
 566  * see RegEnumKeyW
 567  */
 568 DWORD WINAPI RegEnumKeyA( HKEY hkey, DWORD index, LPSTR name, DWORD name_len )
 569 {
 570     return RegEnumKeyExA( hkey, index, name, &name_len, NULL, NULL, NULL, NULL );
 571 }
 572
 573
 574 /******************************************************************************
 575  * RegQueryInfoKeyW   [ADVAPI32.@]
 576  *
 577  * PARAMS
 578  *    hkey       [I] Handle to key to query
 579  *    class      [O] Buffer for class string
 580  *    class_len  [O] Size of class string buffer
 581  *    reserved   [I] Reserved
 582  *    subkeys    [O] Buffer for number of subkeys
 583  *    max_subkey [O] Buffer for longest subkey name length
 584  *    max_class  [O] Buffer for longest class string length
 585  *    values     [O] Buffer for number of value entries
 586  *    max_value  [O] Buffer for longest value name length
 587  *    max_data   [O] Buffer for longest value data length
 588  *    security   [O] Buffer for security descriptor length
 589  *    modif      [O] Modification time
 590  *
 591  * - win95 allows class to be valid and class_len to be NULL
 592  * - winnt returns ERROR_INVALID_PARAMETER if class is valid and class_len is NULL
 593  * - both allow class to be NULL and class_len to be NULL
 594  * (it's hard to test validity, so test !NULL instead)
 595  */
 596 DWORD WINAPI RegQueryInfoKeyW( HKEY hkey, LPWSTR class, LPDWORD class_len, LPDWORD reserved,
 597                                LPDWORD subkeys, LPDWORD max_subkey, LPDWORD max_class,
 598                                LPDWORD values, LPDWORD max_value, LPDWORD max_data,
 599                                LPDWORD security, FILETIME *modif )
 600 {
 601     NTSTATUS status;
 602     char buffer[256], *buf_ptr = buffer;
 603     KEY_FULL_INFORMATION *info = (KEY_FULL_INFORMATION *)buffer;
 604     DWORD total_size;
 605
 606     TRACE( "(%p,%p,%ld,%p,%p,%p,%p,%p,%p,%p,%p)\n", hkey, class, class_len ? *class_len : 0,
 607            reserved, subkeys, max_subkey, values, max_value, max_data, security, modif );
 608
 609     if (class && !class_len && is_version_nt()) return ERROR_INVALID_PARAMETER;
 610     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
 611
 612     status = NtQueryKey( hkey, KeyFullInformation, buffer, sizeof(buffer), &total_size );
 613     if (status && status != STATUS_BUFFER_OVERFLOW) goto done;
 614
 615     if (class)
 616     {
 617         /* retry with a dynamically allocated buffer */
 618         while (status == STATUS_BUFFER_OVERFLOW)
 619         {
 620             if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
 621             if (!(buf_ptr = HeapAlloc( GetProcessHeap(), 0, total_size )))
 622                 return ERROR_NOT_ENOUGH_MEMORY;
 623             info = (KEY_FULL_INFORMATION *)buf_ptr;
 624             status = NtQueryKey( hkey, KeyFullInformation, buf_ptr, total_size, &total_size );
 625         }
 626
 627         if (status) goto done;
 628
 629         if (class_len && (info->ClassLength/sizeof(WCHAR) + 1 > *class_len))
 630         {
 631             status = STATUS_BUFFER_OVERFLOW;
 632         }
 633         else
 634         {
 635             memcpy( class, buf_ptr + info->ClassOffset, info->ClassLength );
 636             class[info->ClassLength/sizeof(WCHAR)] = 0;
 637         }
 638     }
 639     else status = STATUS_SUCCESS;
 640
 641     if (class_len) *class_len = info->ClassLength / sizeof(WCHAR);
 642     if (subkeys) *subkeys = info->SubKeys;
 643     if (max_subkey) *max_subkey = info->MaxNameLen;
 644     if (max_class) *max_class = info->MaxClassLen;
 645     if (values) *values = info->Values;
 646     if (max_value) *max_value = info->MaxValueNameLen;
 647     if (max_data) *max_data = info->MaxValueDataLen;
 648     if (modif) *modif = *(FILETIME *)&info->LastWriteTime;
 649
 650  done:
 651     if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
 652     return RtlNtStatusToDosError( status );
 653 }
 654
 655
 656 /******************************************************************************
 657  * RegQueryMultipleValuesA   [ADVAPI32.@]
 658  *
 659  * Retrieves the type and data for a list of value names associated with a key.
 660  *
 661  * PARAMS
 662  *  hKey       [I] Handle to an open key.
 663  *  val_list   [O] Array of VALENT structures that describes the entries.
 664  *  num_vals   [I] Number of elements in val_list.
 665  *  lpValueBuf [O] Pointer to a buffer that receives the data for each value.
 666  *  ldwTotsize [I/O] Size of lpValueBuf.
 667  *
 668  * RETURNS
 669  *  Success: ERROR_SUCCESS. ldwTotsize contains num bytes copied.
 670  *  Failure: nonzero error code from Winerror.h ldwTotsize contains num needed
 671  *           bytes.
 672  */
 673 DWORD WINAPI RegQueryMultipleValuesA(HKEY hkey, PVALENTA val_list, DWORD num_vals,
 674                                      LPSTR lpValueBuf, LPDWORD ldwTotsize)
 675 {
 676     unsigned int i;
 677     DWORD maxBytes = *ldwTotsize;
 678     HRESULT status;
 679     LPSTR bufptr = lpValueBuf;
 680     *ldwTotsize = 0;
 681
 682     TRACE("(%p,%p,%ld,%p,%p=%ld)\n", hkey, val_list, num_vals, lpValueBuf, ldwTotsize, *ldwTotsize);
 683
 684     for(i=0; i < num_vals; ++i)
 685     {
 686
 687         val_list[i].ve_valuelen=0;
 688         status = RegQueryValueExA(hkey, val_list[i].ve_valuename, NULL, NULL, NULL, &val_list[i].ve_valuelen);
 689         if(status != ERROR_SUCCESS)
 690         {
 691             return status;
 692         }
 693
 694         if(lpValueBuf != NULL && *ldwTotsize + val_list[i].ve_valuelen <= maxBytes)
 695         {
 696             status = RegQueryValueExA(hkey, val_list[i].ve_valuename, NULL, &val_list[i].ve_type,
 697                                       (LPBYTE)bufptr, &val_list[i].ve_valuelen);
 698             if(status != ERROR_SUCCESS)
 699             {
 700                 return status;
 701             }
 702
 703             val_list[i].ve_valueptr = (DWORD_PTR)bufptr;
 704
 705             bufptr += val_list[i].ve_valuelen;
 706         }
 707
 708         *ldwTotsize += val_list[i].ve_valuelen;
 709     }
 710     return lpValueBuf != NULL && *ldwTotsize <= maxBytes ? ERROR_SUCCESS : ERROR_MORE_DATA;
 711 }
 712
 713
 714 /******************************************************************************
 715  * RegQueryMultipleValuesW   [ADVAPI32.@]
 716  *
 717  * see RegQueryMultipleValuesA
 718  */
 719 DWORD WINAPI RegQueryMultipleValuesW(HKEY hkey, PVALENTW val_list, DWORD num_vals,
 720                                      LPWSTR lpValueBuf, LPDWORD ldwTotsize)
 721 {
 722     unsigned int i;
 723     DWORD maxBytes = *ldwTotsize;
 724     HRESULT status;
 725     LPSTR bufptr = (LPSTR)lpValueBuf;
 726     *ldwTotsize = 0;
 727
 728     TRACE("(%p,%p,%ld,%p,%p=%ld)\n", hkey, val_list, num_vals, lpValueBuf, ldwTotsize, *ldwTotsize);
 729
 730     for(i=0; i < num_vals; ++i)
 731     {
 732         val_list[i].ve_valuelen=0;
 733         status = RegQueryValueExW(hkey, val_list[i].ve_valuename, NULL, NULL, NULL, &val_list[i].ve_valuelen);
 734         if(status != ERROR_SUCCESS)
 735         {
 736             return status;
 737         }
 738
 739         if(lpValueBuf != NULL && *ldwTotsize + val_list[i].ve_valuelen <= maxBytes)
 740         {
 741             status = RegQueryValueExW(hkey, val_list[i].ve_valuename, NULL, &val_list[i].ve_type,
 742                                       (LPBYTE)bufptr, &val_list[i].ve_valuelen);
 743             if(status != ERROR_SUCCESS)
 744             {
 745                 return status;
 746             }
 747
 748             val_list[i].ve_valueptr = (DWORD_PTR)bufptr;
 749
 750             bufptr += val_list[i].ve_valuelen;
 751         }
 752
 753         *ldwTotsize += val_list[i].ve_valuelen;
 754     }
 755     return lpValueBuf != NULL && *ldwTotsize <= maxBytes ? ERROR_SUCCESS : ERROR_MORE_DATA;
 756 }
 757
 758 /******************************************************************************
 759  * RegQueryInfoKeyA   [ADVAPI32.@]
 760  *
 761  * Retrieves information about a registry key.
 762  *
 763  * PARAMS
 764  *  hKey                   [I] Handle to an open key.
 765  *  lpClass                [O] Class string of the key.
 766  *  lpcClass               [I/O] size of lpClass.
 767  *  lpReserved             [I] Reserved; must be NULL.
 768  *  lpcSubKeys             [O] Number of subkeys contained by the key.
 769  *  lpcMaxSubKeyLen        [O] Size of the key's subkey with the longest name.
 770  *  lpcMaxClassLen         [O] Size of the longest string specifying a subkey
 771  *                             class in TCHARS.
 772  *  lpcValues              [O] Number of values associated with the key.
 773  *  lpcMaxValueNameLen     [O] Size of the key's longest value name in TCHARS.
 774  *  lpcMaxValueLen         [O] Longest data component among the key's values
 775  *  lpcbSecurityDescriptor [O] Size of the key's security descriptor.
 776  *  lpftLastWriteTime      [O] FILETIME strucutre that is the last write time.
 777  *
 778  *  RETURNS
 779  *   Success: ERROR_SUCCESS
 780  *   Failure: nonzero error code from Winerror.h
 781  */
 782 DWORD WINAPI RegQueryInfoKeyA( HKEY hkey, LPSTR class, LPDWORD class_len, LPDWORD reserved,
 783                                LPDWORD subkeys, LPDWORD max_subkey, LPDWORD max_class,
 784                                LPDWORD values, LPDWORD max_value, LPDWORD max_data,
 785                                LPDWORD security, FILETIME *modif )
 786 {
 787     NTSTATUS status;
 788     char buffer[256], *buf_ptr = buffer;
 789     KEY_FULL_INFORMATION *info = (KEY_FULL_INFORMATION *)buffer;
 790     DWORD total_size, len;
 791
 792     TRACE( "(%p,%p,%ld,%p,%p,%p,%p,%p,%p,%p,%p)\n", hkey, class, class_len ? *class_len : 0,
 793            reserved, subkeys, max_subkey, values, max_value, max_data, security, modif );
 794
 795     if (class && !class_len && is_version_nt()) return ERROR_INVALID_PARAMETER;
 796     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
 797
 798     status = NtQueryKey( hkey, KeyFullInformation, buffer, sizeof(buffer), &total_size );
 799     if (status && status != STATUS_BUFFER_OVERFLOW) goto done;
 800
 801     if (class || class_len)
 802     {
 803         /* retry with a dynamically allocated buffer */
 804         while (status == STATUS_BUFFER_OVERFLOW)
 805         {
 806             if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
 807             if (!(buf_ptr = HeapAlloc( GetProcessHeap(), 0, total_size )))
 808                 return ERROR_NOT_ENOUGH_MEMORY;
 809             info = (KEY_FULL_INFORMATION *)buf_ptr;
 810             status = NtQueryKey( hkey, KeyFullInformation, buf_ptr, total_size, &total_size );
 811         }
 812
 813         if (status) goto done;
 814
 815         RtlUnicodeToMultiByteSize( &len, (WCHAR *)(buf_ptr + info->ClassOffset), info->ClassLength);
 816         if (class_len)
 817         {
 818             if (len + 1 > *class_len) status = STATUS_BUFFER_OVERFLOW;
 819             *class_len = len;
 820         }
 821         if (class && !status)
 822         {
 823             RtlUnicodeToMultiByteN( class, len, NULL, (WCHAR *)(buf_ptr + info->ClassOffset),
 824                                     info->ClassLength );
 825             class[len] = 0;
 826         }
 827     }
 828     else status = STATUS_SUCCESS;
 829
 830     if (subkeys) *subkeys = info->SubKeys;
 831     if (max_subkey) *max_subkey = info->MaxNameLen;
 832     if (max_class) *max_class = info->MaxClassLen;
 833     if (values) *values = info->Values;
 834     if (max_value) *max_value = info->MaxValueNameLen;
 835     if (max_data) *max_data = info->MaxValueDataLen;
 836     if (modif) *modif = *(FILETIME *)&info->LastWriteTime;
 837
 838  done:
 839     if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
 840     return RtlNtStatusToDosError( status );
 841 }
 842
 843
 844 /******************************************************************************
 845  * RegCloseKey   [ADVAPI32.@]
 846  *
 847  * Close an open registry key.
 848  *
 849  * PARAMS
 850  *  hkey [I] Handle of key to close
 851  *
 852  * RETURNS
 853  *  Success: ERROR_SUCCESS
 854  *  Failure: Error code
 855  */
 856 DWORD WINAPI RegCloseKey( HKEY hkey )
 857 {
 858     if (!hkey) return ERROR_INVALID_HANDLE;
 859     if (hkey >= (HKEY)0x80000000) return ERROR_SUCCESS;
 860     return RtlNtStatusToDosError( NtClose( hkey ) );
 861 }
 862
 863
 864 /******************************************************************************
 865  * RegDeleteKeyW   [ADVAPI32.@]
 866  *
 867  * See RegDeleteKeyA.
 868  */
 869 DWORD WINAPI RegDeleteKeyW( HKEY hkey, LPCWSTR name )
 870 {
 871     DWORD ret;
 872     HKEY tmp;
 873
 874     if (!name) return ERROR_INVALID_PARAMETER;
 875
 876     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
 877
 878     if (!(ret = RegOpenKeyExW( hkey, name, 0, DELETE, &tmp )))
 879     {
 880         ret = RtlNtStatusToDosError( NtDeleteKey( tmp ) );
 881         RegCloseKey( tmp );
 882     }
 883     TRACE("%s ret=%08lx\n", debugstr_w(name), ret);
 884     return ret;
 885 }
 886
 887
 888 /******************************************************************************
 889  * RegDeleteKeyA   [ADVAPI32.@]
 890  *
 891  * Delete a registry key.
 892  *
 893  * PARAMS
 894  *  hkey   [I] Handle to parent key containing the key to delete
 895  *  name   [I] Name of the key user hkey to delete
 896  *
 897  * NOTES
 898  *
 899  * MSDN is wrong when it says that hkey must be opened with the DELETE access
 900  * right. In reality, it opens a new handle with DELETE access.
 901  *
 902  * RETURNS
 903  *  Success: ERROR_SUCCESS
 904  *  Failure: Error code
 905  */
 906 DWORD WINAPI RegDeleteKeyA( HKEY hkey, LPCSTR name )
 907 {
 908     DWORD ret;
 909     HKEY tmp;
 910
 911     if (!name) return ERROR_INVALID_PARAMETER;
 912
 913     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
 914
 915     if (!(ret = RegOpenKeyExA( hkey, name, 0, DELETE, &tmp )))
 916     {
 917         if (!is_version_nt()) /* win95 does recursive key deletes */
 918         {
 919             CHAR name[MAX_PATH];
 920
 921             while(!RegEnumKeyA(tmp, 0, name, sizeof(name)))
 922             {
 923                 if(RegDeleteKeyA(tmp, name))  /* recurse */
 924                     break;
 925             }
 926         }
 927         ret = RtlNtStatusToDosError( NtDeleteKey( tmp ) );
 928         RegCloseKey( tmp );
 929     }
 930     TRACE("%s ret=%08lx\n", debugstr_a(name), ret);
 931     return ret;
 932 }
 933
 934
 935
 936 /******************************************************************************
 937  * RegSetValueExW   [ADVAPI32.@]
 938  *
 939  * Set the data and contents of a registry value.
 940  *
 941  * PARAMS
 942  *  hkey       [I] Handle of key to set value for
 943  *  name       [I] Name of value to set
 944  *  reserved   [I] Reserved, must be zero
 945  *  type       [I] Type of the value being set
 946  *  data       [I] The new contents of the value to set
 947  *  count      [I] Size of data
 948  *
 949  * RETURNS
 950  *  Success: ERROR_SUCCESS
 951  *  Failure: Error code
 952  */
 953 DWORD WINAPI RegSetValueExW( HKEY hkey, LPCWSTR name, DWORD reserved,
 954                              DWORD type, CONST BYTE *data, DWORD count )
 955 {
 956     UNICODE_STRING nameW;
 957
 958     /* no need for version check, not implemented on win9x anyway */
 959     if (count && is_string(type))
 960     {
 961         LPCWSTR str = (LPCWSTR)data;
 962         /* if user forgot to count terminating null, add it (yes NT does this) */
 963         if (str[count / sizeof(WCHAR) - 1] && !str[count / sizeof(WCHAR)])
 964             count += sizeof(WCHAR);
 965     }
 966     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
 967
 968     RtlInitUnicodeString( &nameW, name );
 969     return RtlNtStatusToDosError( NtSetValueKey( hkey, &nameW, 0, type, data, count ) );
 970 }
 971
 972
 973 /******************************************************************************
 974  * RegSetValueExA   [ADVAPI32.@]
 975  *
 976  * see RegSetValueExW
 977  *
 978  * NOTES
 979  *  win95 does not care about count for REG_SZ and finds out the len by itself (js)
 980  *  NT does definitely care (aj)
 981  */
 982 DWORD WINAPI RegSetValueExA( HKEY hkey, LPCSTR name, DWORD reserved, DWORD type,
 983                              CONST BYTE *data, DWORD count )
 984 {
 985     ANSI_STRING nameA;
 986     WCHAR *dataW = NULL;
 987     NTSTATUS status;
 988
 989     if (!is_version_nt())  /* win95 */
 990     {
 991         if (type == REG_SZ)
 992         {
 993             if (!data) return ERROR_INVALID_PARAMETER;
 994             count = strlen((const char *)data) + 1;
 995         }
 996     }
 997     else if (count && is_string(type))
 998     {
 999         /* if user forgot to count terminating null, add it (yes NT does this) */
1000         if (data[count-1] && !data[count]) count++;
1001     }
1002
1003     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
1004
1005     if (is_string( type )) /* need to convert to Unicode */
1006     {
1007         DWORD lenW;
1008         RtlMultiByteToUnicodeSize( &lenW, (const char *)data, count );
1009         if (!(dataW = HeapAlloc( GetProcessHeap(), 0, lenW ))) return ERROR_OUTOFMEMORY;
1010         RtlMultiByteToUnicodeN( dataW, lenW, NULL, (const char *)data, count );
1011         count = lenW;
1012         data = (BYTE *)dataW;
1013     }
1014
1015     RtlInitAnsiString( &nameA, name );
1016     if (!(status = RtlAnsiStringToUnicodeString( &NtCurrentTeb()->StaticUnicodeString,
1017                                                  &nameA, FALSE )))
1018     {
1019         status = NtSetValueKey( hkey, &NtCurrentTeb()->StaticUnicodeString, 0, type, data, count );
1020     }
1021     HeapFree( GetProcessHeap(), 0, dataW );
1022     return RtlNtStatusToDosError( status );
1023 }
1024
1025
1026 /******************************************************************************
1027  * RegSetValueW   [ADVAPI32.@]
1028  *
1029  * Sets the data for the default or unnamed value of a reg key.
1030  *
1031  * PARAMS
1032  *  hKey     [I] Handle to an open key.
1033  *  lpSubKey [I] Name of a subkey of hKey.
1034  *  dwType   [I] Type of information to store.
1035  *  lpData   [I] String that contains the data to set for the default value.
1036  *  cbData   [I] Size of lpData.
1037  *
1038  * RETURNS
1039  *  Success: ERROR_SUCCESS
1040  *  Failure: nonzero error code from Winerror.h
1041  */
1042 DWORD WINAPI RegSetValueW( HKEY hkey, LPCWSTR name, DWORD type, LPCWSTR data, DWORD count )
1043 {
1044     HKEY subkey = hkey;
1045     DWORD ret;
1046
1047     TRACE("(%p,%s,%ld,%s,%ld)\n", hkey, debugstr_w(name), type, debugstr_w(data), count );
1048
1049     if (type != REG_SZ) return ERROR_INVALID_PARAMETER;
1050
1051     if (name && name[0])  /* need to create the subkey */
1052     {
1053         if ((ret = RegCreateKeyW( hkey, name, &subkey )) != ERROR_SUCCESS) return ret;
1054     }
1055
1056     ret = RegSetValueExW( subkey, NULL, 0, REG_SZ, (const BYTE*)data,
1057                           (strlenW( data ) + 1) * sizeof(WCHAR) );
1058     if (subkey != hkey) RegCloseKey( subkey );
1059     return ret;
1060 }
1061
1062
1063 /******************************************************************************
1064  * RegSetValueA   [ADVAPI32.@]
1065  *
1066  * see RegSetValueW
1067  */
1068 DWORD WINAPI RegSetValueA( HKEY hkey, LPCSTR name, DWORD type, LPCSTR data, DWORD count )
1069 {
1070     HKEY subkey = hkey;
1071     DWORD ret;
1072
1073     TRACE("(%p,%s,%ld,%s,%ld)\n", hkey, debugstr_a(name), type, debugstr_a(data), count );
1074
1075     if (type != REG_SZ) return ERROR_INVALID_PARAMETER;
1076
1077     if (name && name[0])  /* need to create the subkey */
1078     {
1079         if ((ret = RegCreateKeyA( hkey, name, &subkey )) != ERROR_SUCCESS) return ret;
1080     }
1081     ret = RegSetValueExA( subkey, NULL, 0, REG_SZ, (const BYTE*)data, strlen(data)+1 );
1082     if (subkey != hkey) RegCloseKey( subkey );
1083     return ret;
1084 }
1085
1086
1087
1088 /******************************************************************************
1089  * RegQueryValueExW   [ADVAPI32.@]
1090  *
1091  * See RegQueryValueExA.
1092  */
1093 DWORD WINAPI RegQueryValueExW( HKEY hkey, LPCWSTR name, LPDWORD reserved, LPDWORD type,
1094                                LPBYTE data, LPDWORD count )
1095 {
1096     NTSTATUS status;
1097     UNICODE_STRING name_str;
1098     DWORD total_size;
1099     char buffer[256], *buf_ptr = buffer;
1100     KEY_VALUE_PARTIAL_INFORMATION *info = (KEY_VALUE_PARTIAL_INFORMATION *)buffer;
1101     static const int info_size = offsetof( KEY_VALUE_PARTIAL_INFORMATION, Data );
1102
1103     TRACE("(%p,%s,%p,%p,%p,%p=%ld)\n",
1104           hkey, debugstr_w(name), reserved, type, data, count,
1105           (count && data) ? *count : 0 );
1106
1107     if ((data && !count) || reserved) return ERROR_INVALID_PARAMETER;
1108     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
1109
1110     RtlInitUnicodeString( &name_str, name );
1111
1112     if (data) total_size = min( sizeof(buffer), *count + info_size );
1113     else total_size = info_size;
1114
1115     status = NtQueryValueKey( hkey, &name_str, KeyValuePartialInformation,
1116                               buffer, total_size, &total_size );
1117     if (status && status != STATUS_BUFFER_OVERFLOW) goto done;
1118
1119     if (data)
1120     {
1121         /* retry with a dynamically allocated buffer */
1122         while (status == STATUS_BUFFER_OVERFLOW && total_size - info_size <= *count)
1123         {
1124             if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
1125             if (!(buf_ptr = HeapAlloc( GetProcessHeap(), 0, total_size )))
1126                 return ERROR_NOT_ENOUGH_MEMORY;
1127             info = (KEY_VALUE_PARTIAL_INFORMATION *)buf_ptr;
1128             status = NtQueryValueKey( hkey, &name_str, KeyValuePartialInformation,
1129                                       buf_ptr, total_size, &total_size );
1130         }
1131
1132         if (!status)
1133         {
1134             memcpy( data, buf_ptr + info_size, total_size - info_size );
1135             /* if the type is REG_SZ and data is not 0-terminated
1136              * and there is enough space in the buffer NT appends a \0 */
1137             if (total_size - info_size <= *count-sizeof(WCHAR) && is_string(info->Type))
1138             {
1139                 WCHAR *ptr = (WCHAR *)(data + total_size - info_size);
1140                 if (ptr > (WCHAR *)data && ptr[-1]) *ptr = 0;
1141             }
1142         }
1143         else if (status != STATUS_BUFFER_OVERFLOW) goto done;
1144     }
1145     else status = STATUS_SUCCESS;
1146
1147     if (type) *type = info->Type;
1148     if (count) *count = total_size - info_size;
1149
1150  done:
1151     if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
1152     return RtlNtStatusToDosError(status);
1153 }
1154
1155
1156 /******************************************************************************
1157  * RegQueryValueExA   [ADVAPI32.@]
1158  *
1159  * Get the type and contents of a specified value under with a key.
1160  *
1161  * PARAMS
1162  *  hkey      [I]   Handle of the key to query
1163  *  name      [I]   Name of value under hkey to query
1164  *  reserved  [I]   Reserved - must be NULL
1165  *  type      [O]   Destination for the value type, or NULL if not required
1166  *  data      [O]   Destination for the values contents, or NULL if not required
1167  *  count     [I/O] Size of data, updated with the number of bytes returned
1168  *
1169  * RETURNS
1170  *  Success: ERROR_SUCCESS. *count is updated with the number of bytes copied to data.
1171  *  Failure: ERROR_INVALID_HANDLE, if hkey is invalid.
1172  *           ERROR_INVALID_PARAMETER, if any other parameter is invalid.
1173  *           ERROR_MORE_DATA, if on input *count is too small to hold the contents.
1174  *
1175  * NOTES
1176  *   MSDN states that if data is too small it is partially filled. In reality
1177  *   it remains untouched.
1178  */
1179 DWORD WINAPI RegQueryValueExA( HKEY hkey, LPCSTR name, LPDWORD reserved, LPDWORD type,
1180                                LPBYTE data, LPDWORD count )
1181 {
1182     NTSTATUS status;
1183     ANSI_STRING nameA;
1184     DWORD total_size;
1185     char buffer[256], *buf_ptr = buffer;
1186     KEY_VALUE_PARTIAL_INFORMATION *info = (KEY_VALUE_PARTIAL_INFORMATION *)buffer;
1187     static const int info_size = offsetof( KEY_VALUE_PARTIAL_INFORMATION, Data );
1188
1189     TRACE("(%p,%s,%p,%p,%p,%p=%ld)\n",
1190           hkey, debugstr_a(name), reserved, type, data, count, count ? *count : 0 );
1191
1192     if ((data && !count) || reserved) return ERROR_INVALID_PARAMETER;
1193     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
1194
1195     RtlInitAnsiString( &nameA, name );
1196     if ((status = RtlAnsiStringToUnicodeString( &NtCurrentTeb()->StaticUnicodeString,
1197                                                 &nameA, FALSE )))
1198         return RtlNtStatusToDosError(status);
1199
1200     status = NtQueryValueKey( hkey, &NtCurrentTeb()->StaticUnicodeString,
1201                               KeyValuePartialInformation, buffer, sizeof(buffer), &total_size );
1202     if (status && status != STATUS_BUFFER_OVERFLOW) goto done;
1203
1204     /* we need to fetch the contents for a string type even if not requested,
1205      * because we need to compute the length of the ASCII string. */
1206     if (data || is_string(info->Type))
1207     {
1208         /* retry with a dynamically allocated buffer */
1209         while (status == STATUS_BUFFER_OVERFLOW)
1210         {
1211             if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
1212             if (!(buf_ptr = HeapAlloc( GetProcessHeap(), 0, total_size )))
1213             {
1214                 status = STATUS_NO_MEMORY;
1215                 goto done;
1216             }
1217             info = (KEY_VALUE_PARTIAL_INFORMATION *)buf_ptr;
1218             status = NtQueryValueKey( hkey, &NtCurrentTeb()->StaticUnicodeString,
1219                                     KeyValuePartialInformation, buf_ptr, total_size, &total_size );
1220         }
1221
1222         if (status) goto done;
1223
1224         if (is_string(info->Type))
1225         {
1226             DWORD len;
1227
1228             RtlUnicodeToMultiByteSize( &len, (WCHAR *)(buf_ptr + info_size),
1229                                        total_size - info_size );
1230             if (data && len)
1231             {
1232                 if (len > *count) status = STATUS_BUFFER_OVERFLOW;
1233                 else
1234                 {
1235                     RtlUnicodeToMultiByteN( (char*)data, len, NULL, (WCHAR *)(buf_ptr + info_size),
1236                                             total_size - info_size );
1237                     /* if the type is REG_SZ and data is not 0-terminated
1238                      * and there is enough space in the buffer NT appends a \0 */
1239                     if (len < *count && data[len-1]) data[len] = 0;
1240                 }
1241             }
1242             total_size = len + info_size;
1243         }
1244         else if (data)
1245         {
1246             if (total_size - info_size > *count) status = STATUS_BUFFER_OVERFLOW;
1247             else memcpy( data, buf_ptr + info_size, total_size - info_size );
1248         }
1249     }
1250     else status = STATUS_SUCCESS;
1251
1252     if (type) *type = info->Type;
1253     if (count) *count = total_size - info_size;
1254
1255  done:
1256     if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
1257     return RtlNtStatusToDosError(status);
1258 }
1259
1260
1261 /******************************************************************************
1262  * RegQueryValueW   [ADVAPI32.@]
1263  *
1264  * Retrieves the data associated with the default or unnamed value of a key.
1265  *
1266  * PARAMS
1267  *  hkey      [I] Handle to an open key.
1268  *  name      [I] Name of the subkey of hKey.
1269  *  data      [O] Receives the string associated with the default value
1270  *                of the key.
1271  *  count     [I/O] Size of lpValue in bytes.
1272  *
1273  *  RETURNS
1274  *   Success: ERROR_SUCCESS
1275  *   Failure: nonzero error code from Winerror.h
1276  */
1277 DWORD WINAPI RegQueryValueW( HKEY hkey, LPCWSTR name, LPWSTR data, LPLONG count )
1278 {
1279     DWORD ret;
1280     HKEY subkey = hkey;
1281
1282     TRACE("(%p,%s,%p,%ld)\n", hkey, debugstr_w(name), data, count ? *count : 0 );
1283
1284     if (name && name[0])
1285     {
1286         if ((ret = RegOpenKeyW( hkey, name, &subkey )) != ERROR_SUCCESS) return ret;
1287     }
1288     ret = RegQueryValueExW( subkey, NULL, NULL, NULL, (LPBYTE)data, (LPDWORD)count );
1289     if (subkey != hkey) RegCloseKey( subkey );
1290     if (ret == ERROR_FILE_NOT_FOUND)
1291     {
1292         /* return empty string if default value not found */
1293         if (data) *data = 0;
1294         if (count) *count = sizeof(WCHAR);
1295         ret = ERROR_SUCCESS;
1296     }
1297     return ret;
1298 }
1299
1300
1301 /******************************************************************************
1302  * RegQueryValueA   [ADVAPI32.@]
1303  *
1304  * see RegQueryValueW
1305  */
1306 DWORD WINAPI RegQueryValueA( HKEY hkey, LPCSTR name, LPSTR data, LPLONG count )
1307 {
1308     DWORD ret;
1309     HKEY subkey = hkey;
1310
1311     TRACE("(%p,%s,%p,%ld)\n", hkey, debugstr_a(name), data, count ? *count : 0 );
1312
1313     if (name && name[0])
1314     {
1315         if ((ret = RegOpenKeyA( hkey, name, &subkey )) != ERROR_SUCCESS) return ret;
1316     }
1317     ret = RegQueryValueExA( subkey, NULL, NULL, NULL, (LPBYTE)data, (LPDWORD)count );
1318     if (subkey != hkey) RegCloseKey( subkey );
1319     if (ret == ERROR_FILE_NOT_FOUND)
1320     {
1321         /* return empty string if default value not found */
1322         if (data) *data = 0;
1323         if (count) *count = 1;
1324         ret = ERROR_SUCCESS;
1325     }
1326     return ret;
1327 }
1328
1329
1330 /******************************************************************************
1331  * ADVAPI_ApplyRestrictions   [internal]
1332  *
1333  * Helper function for RegGetValueA/W.
1334  */
1335 VOID ADVAPI_ApplyRestrictions( DWORD dwFlags, DWORD dwType, DWORD cbData,
1336                                PLONG ret )
1337 {
1338     /* Check if the type is restricted by the passed flags */
1339     if (*ret == ERROR_SUCCESS || *ret == ERROR_MORE_DATA)
1340     {
1341         DWORD dwMask = 0;
1342
1343         switch (dwType)
1344         {
1345         case REG_NONE: dwMask = RRF_RT_REG_NONE; break;
1346         case REG_SZ: dwMask = RRF_RT_REG_SZ; break;
1347         case REG_EXPAND_SZ: dwMask = RRF_RT_REG_EXPAND_SZ; break;
1348         case REG_MULTI_SZ: dwMask = RRF_RT_REG_MULTI_SZ; break;
1349         case REG_BINARY: dwMask = RRF_RT_REG_BINARY; break;
1350         case REG_DWORD: dwMask = RRF_RT_REG_DWORD; break;
1351         case REG_QWORD: dwMask = RRF_RT_REG_QWORD; break;
1352         }
1353
1354         if (dwFlags & dwMask)
1355         {
1356             /* Type is not restricted, check for size mismatch */
1357             if (dwType == REG_BINARY)
1358             {
1359                 DWORD cbExpect = 0;
1360
1361                 if ((dwFlags & RRF_RT_DWORD) == RRF_RT_DWORD)
1362                     cbExpect = 4;
1363                 else if ((dwFlags & RRF_RT_DWORD) == RRF_RT_QWORD)
1364                     cbExpect = 8;
1365
1366                 if (cbExpect && cbData != cbExpect)
1367                     *ret = ERROR_DATATYPE_MISMATCH;
1368             }
1369         }
1370         else *ret = ERROR_UNSUPPORTED_TYPE;
1371     }
1372 }
1373
1374
1375 /******************************************************************************
1376  * RegGetValueW   [ADVAPI32.@]
1377  *
1378  * Retrieves the type and data for a value name associated with a key
1379  * optionally expanding it's content and restricting it's type.
1380  *
1381  * PARAMS
1382  *  hKey      [I] Handle to an open key.
1383  *  pszSubKey [I] Name of the subkey of hKey.
1384  *  pszValue  [I] Name of value under hKey/szSubKey to query.
1385  *  dwFlags   [I] Flags restricting the value type to retrieve.
1386  *  pdwType   [O] Destination for the values type, may be NULL.
1387  *  pvData    [O] Destination for the values content, may be NULL.
1388  *  pcbData   [I/O] Size of pvData, updated with the size required to
1389  *                  retrieve the whole content.
1390  *
1391  * RETURNS
1392  *  Success: ERROR_SUCCESS
1393  *  Failure: nonzero error code from Winerror.h
1394  *
1395  * NOTES
1396  *  - Unless RRF_NOEXPAND is specified REG_EXPAND_SZ is automatically expanded
1397  *    and REG_SZ is retrieved instead.
1398  *  - Restrictions are applied after expanding, using RRF_RT_REG_EXPAND_SZ
1399  *    without RRF_NOEXPAND is thus not allowed.
1400  */
1401 LONG WINAPI RegGetValueW( HKEY hKey, LPCWSTR pszSubKey, LPCWSTR pszValue,
1402                           DWORD dwFlags, LPDWORD pdwType, PVOID pvData,
1403                           LPDWORD pcbData )
1404 {
1405     DWORD dwType, cbData = pcbData ? *pcbData : 0;
1406     PVOID pvBuf = NULL;
1407     LONG ret;
1408
1409     TRACE("(%p,%s,%s,%ld,%p,%p,%p=%ld)\n",
1410           hKey, debugstr_w(pszSubKey), debugstr_w(pszValue), dwFlags, pdwType,
1411           pvData, pcbData, cbData);
1412
1413     if ((dwFlags & RRF_RT_REG_EXPAND_SZ) && !(dwFlags & RRF_NOEXPAND))
1414         return ERROR_INVALID_PARAMETER;
1415
1416     if (pszSubKey && pszSubKey[0])
1417     {
1418         ret = RegOpenKeyExW(hKey, pszSubKey, 0, KEY_QUERY_VALUE, &hKey);
1419         if (ret != ERROR_SUCCESS) return ret;
1420     }
1421
1422     ret = RegQueryValueExW(hKey, pszValue, NULL, &dwType, pvData, &cbData);
1423
1424     /* If we are going to expand we need to read in the whole the value even
1425      * if the passed buffer was too small as the expanded string might be
1426      * smaller than the unexpanded one and could fit into cbData bytes. */
1427     if ((ret == ERROR_SUCCESS || ret == ERROR_MORE_DATA) &&
1428         (dwType == REG_EXPAND_SZ && !(dwFlags & RRF_NOEXPAND)))
1429     {
1430         do {
1431             if (pvBuf) HeapFree(GetProcessHeap(), 0, pvBuf);
1432
1433             pvBuf = HeapAlloc(GetProcessHeap(), 0, cbData);
1434             if (!pvBuf)
1435             {
1436                 ret = ERROR_NOT_ENOUGH_MEMORY;
1437                 break;
1438             }
1439
1440             if (ret == ERROR_MORE_DATA)
1441                 ret = RegQueryValueExW(hKey, pszValue, NULL,
1442                                        &dwType, pvBuf, &cbData);
1443             else
1444             {
1445                 /* Even if cbData was large enough we have to copy the
1446                  * string since ExpandEnvironmentStrings can't handle
1447                  * overlapping buffers. */
1448                 CopyMemory(pvBuf, pvData, cbData);
1449             }
1450
1451             /* Both the type or the value itself could have been modified in
1452              * between so we have to keep retrying until the buffer is large
1453              * enough or we no longer have to expand the value. */
1454         } while (dwType == REG_EXPAND_SZ && ret == ERROR_MORE_DATA);
1455
1456         if (ret == ERROR_SUCCESS)
1457         {
1458             if (dwType == REG_EXPAND_SZ)
1459             {
1460                 cbData = ExpandEnvironmentStringsW(pvBuf, pvData,
1461                                                    pcbData ? *pcbData : 0);
1462                 dwType = REG_SZ;
1463                 if(pcbData && cbData > *pcbData)
1464                     ret = ERROR_MORE_DATA;
1465             }
1466             else if (pcbData)
1467                 CopyMemory(pvData, pvBuf, *pcbData);
1468         }
1469
1470         if (pvBuf) HeapFree(GetProcessHeap(), 0, pvBuf);
1471     }
1472
1473     if (pszSubKey && pszSubKey[0])
1474         RegCloseKey(hKey);
1475
1476     ADVAPI_ApplyRestrictions(dwFlags, dwType, cbData, &ret);
1477
1478     if (pcbData && ret != ERROR_SUCCESS && (dwFlags & RRF_ZEROONFAILURE))
1479         ZeroMemory(pvData, *pcbData);
1480
1481     if (pdwType) *pdwType = dwType;
1482     if (pcbData) *pcbData = cbData;
1483
1484     return ret;
1485 }
1486
1487
1488 /******************************************************************************
1489  * RegGetValueA   [ADVAPI32.@]
1490  *
1491  * See RegGetValueW.
1492  */
1493 LONG WINAPI RegGetValueA( HKEY hKey, LPCSTR pszSubKey, LPCSTR pszValue,
1494                           DWORD dwFlags, LPDWORD pdwType, PVOID pvData,
1495                           LPDWORD pcbData )
1496 {
1497     DWORD dwType, cbData = pcbData ? *pcbData : 0;
1498     PVOID pvBuf = NULL;
1499     LONG ret;
1500
1501     TRACE("(%p,%s,%s,%ld,%p,%p,%p=%ld)\n",
1502           hKey, pszSubKey, pszValue, dwFlags, pdwType, pvData, pcbData,
1503           cbData);
1504
1505     if ((dwFlags & RRF_RT_REG_EXPAND_SZ) && !(dwFlags & RRF_NOEXPAND))
1506         return ERROR_INVALID_PARAMETER;
1507
1508     if (pszSubKey && pszSubKey[0])
1509     {
1510         ret = RegOpenKeyExA(hKey, pszSubKey, 0, KEY_QUERY_VALUE, &hKey);
1511         if (ret != ERROR_SUCCESS) return ret;
1512     }
1513
1514     ret = RegQueryValueExA(hKey, pszValue, NULL, &dwType, pvData, &cbData);
1515
1516     /* If we are going to expand we need to read in the whole the value even
1517      * if the passed buffer was too small as the expanded string might be
1518      * smaller than the unexpanded one and could fit into cbData bytes. */
1519     if ((ret == ERROR_SUCCESS || ret == ERROR_MORE_DATA) &&
1520         (dwType == REG_EXPAND_SZ && !(dwFlags & RRF_NOEXPAND)))
1521     {
1522         do {
1523             if (pvBuf) HeapFree(GetProcessHeap(), 0, pvBuf);
1524
1525             pvBuf = HeapAlloc(GetProcessHeap(), 0, cbData);
1526             if (!pvBuf)
1527             {
1528                 ret = ERROR_NOT_ENOUGH_MEMORY;
1529                 break;
1530             }
1531
1532             if (ret == ERROR_MORE_DATA)
1533                 ret = RegQueryValueExA(hKey, pszValue, NULL,
1534                                        &dwType, pvBuf, &cbData);
1535             else
1536             {
1537                 /* Even if cbData was large enough we have to copy the
1538                  * string since ExpandEnvironmentStrings can't handle
1539                  * overlapping buffers. */
1540                 CopyMemory(pvBuf, pvData, cbData);
1541             }
1542
1543             /* Both the type or the value itself could have been modified in
1544              * between so we have to keep retrying until the buffer is large
1545              * enough or we no longer have to expand the value. */
1546         } while (dwType == REG_EXPAND_SZ && ret == ERROR_MORE_DATA);
1547
1548         if (ret == ERROR_SUCCESS)
1549         {
1550             if (dwType == REG_EXPAND_SZ)
1551             {
1552                 cbData = ExpandEnvironmentStringsA(pvBuf, pvData,
1553                                                    pcbData ? *pcbData : 0);
1554                 dwType = REG_SZ;
1555                 if(pcbData && cbData > *pcbData)
1556                     ret = ERROR_MORE_DATA;
1557             }
1558             else if (pcbData)
1559                 CopyMemory(pvData, pvBuf, *pcbData);
1560         }
1561
1562         if (pvBuf) HeapFree(GetProcessHeap(), 0, pvBuf);
1563     }
1564
1565     if (pszSubKey && pszSubKey[0])
1566         RegCloseKey(hKey);
1567
1568     ADVAPI_ApplyRestrictions(dwFlags, dwType, cbData, &ret);
1569
1570     if (pcbData && ret != ERROR_SUCCESS && (dwFlags & RRF_ZEROONFAILURE))
1571         ZeroMemory(pvData, *pcbData);
1572
1573     if (pdwType) *pdwType = dwType;
1574     if (pcbData) *pcbData = cbData;
1575
1576     return ret;
1577 }
1578
1579
1580 /******************************************************************************
1581  * RegEnumValueW   [ADVAPI32.@]
1582  *
1583  * PARAMS
1584  *  hkey       [I] Handle to key to query
1585  *  index      [I] Index of value to query
1586  *  value      [O] Value string
1587  *  val_count  [I/O] Size of value buffer (in wchars)
1588  *  reserved   [I] Reserved
1589  *  type       [O] Type code
1590  *  data       [O] Value data
1591  *  count      [I/O] Size of data buffer (in bytes)
1592  *
1593  * RETURNS
1594  *  Success: ERROR_SUCCESS
1595  *  Failure: nonzero error code from Winerror.h
1596  */
1597
1598 DWORD WINAPI RegEnumValueW( HKEY hkey, DWORD index, LPWSTR value, LPDWORD val_count,
1599                             LPDWORD reserved, LPDWORD type, LPBYTE data, LPDWORD count )
1600 {
1601     NTSTATUS status;
1602     DWORD total_size;
1603     char buffer[256], *buf_ptr = buffer;
1604     KEY_VALUE_FULL_INFORMATION *info = (KEY_VALUE_FULL_INFORMATION *)buffer;
1605     static const int info_size = offsetof( KEY_VALUE_FULL_INFORMATION, Name );
1606
1607     TRACE("(%p,%ld,%p,%p,%p,%p,%p,%p)\n",
1608           hkey, index, value, val_count, reserved, type, data, count );
1609
1610     /* NT only checks count, not val_count */
1611     if ((data && !count) || reserved) return ERROR_INVALID_PARAMETER;
1612     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
1613
1614     total_size = info_size + (MAX_PATH + 1) * sizeof(WCHAR);
1615     if (data) total_size += *count;
1616     total_size = min( sizeof(buffer), total_size );
1617
1618     status = NtEnumerateValueKey( hkey, index, KeyValueFullInformation,
1619                                   buffer, total_size, &total_size );
1620     if (status && status != STATUS_BUFFER_OVERFLOW) goto done;
1621
1622     if (value || data)
1623     {
1624         /* retry with a dynamically allocated buffer */
1625         while (status == STATUS_BUFFER_OVERFLOW)
1626         {
1627             if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
1628             if (!(buf_ptr = HeapAlloc( GetProcessHeap(), 0, total_size )))
1629                 return ERROR_NOT_ENOUGH_MEMORY;
1630             info = (KEY_VALUE_FULL_INFORMATION *)buf_ptr;
1631             status = NtEnumerateValueKey( hkey, index, KeyValueFullInformation,
1632                                           buf_ptr, total_size, &total_size );
1633         }
1634
1635         if (status) goto done;
1636
1637         if (value)
1638         {
1639             if (info->NameLength/sizeof(WCHAR) >= *val_count)
1640             {
1641                 status = STATUS_BUFFER_OVERFLOW;
1642                 goto overflow;
1643             }
1644             memcpy( value, info->Name, info->NameLength );
1645             *val_count = info->NameLength / sizeof(WCHAR);
1646             value[*val_count] = 0;
1647         }
1648
1649         if (data)
1650         {
1651             if (total_size - info->DataOffset > *count)
1652             {
1653                 status = STATUS_BUFFER_OVERFLOW;
1654                 goto overflow;
1655             }
1656             memcpy( data, buf_ptr + info->DataOffset, total_size - info->DataOffset );
1657             if (total_size - info->DataOffset <= *count-sizeof(WCHAR) && is_string(info->Type))
1658             {
1659                 /* if the type is REG_SZ and data is not 0-terminated
1660                  * and there is enough space in the buffer NT appends a \0 */
1661                 WCHAR *ptr = (WCHAR *)(data + total_size - info->DataOffset);
1662                 if (ptr > (WCHAR *)data && ptr[-1]) *ptr = 0;
1663             }
1664         }
1665     }
1666     else status = STATUS_SUCCESS;
1667
1668  overflow:
1669     if (type) *type = info->Type;
1670     if (count) *count = info->DataLength;
1671
1672  done:
1673     if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
1674     return RtlNtStatusToDosError(status);
1675 }
1676
1677
1678 /******************************************************************************
1679  * RegEnumValueA   [ADVAPI32.@]
1680  *
1681  * see RegEnumValueW
1682  */
1683 DWORD WINAPI RegEnumValueA( HKEY hkey, DWORD index, LPSTR value, LPDWORD val_count,
1684                             LPDWORD reserved, LPDWORD type, LPBYTE data, LPDWORD count )
1685 {
1686     NTSTATUS status;
1687     DWORD total_size;
1688     char buffer[256], *buf_ptr = buffer;
1689     KEY_VALUE_FULL_INFORMATION *info = (KEY_VALUE_FULL_INFORMATION *)buffer;
1690     static const int info_size = offsetof( KEY_VALUE_FULL_INFORMATION, Name );
1691
1692     TRACE("(%p,%ld,%p,%p,%p,%p,%p,%p)\n",
1693           hkey, index, value, val_count, reserved, type, data, count );
1694
1695     /* NT only checks count, not val_count */
1696     if ((data && !count) || reserved) return ERROR_INVALID_PARAMETER;
1697     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
1698
1699     total_size = info_size + (MAX_PATH + 1) * sizeof(WCHAR);
1700     if (data) total_size += *count;
1701     total_size = min( sizeof(buffer), total_size );
1702
1703     status = NtEnumerateValueKey( hkey, index, KeyValueFullInformation,
1704                                   buffer, total_size, &total_size );
1705     if (status && status != STATUS_BUFFER_OVERFLOW) goto done;
1706
1707     /* we need to fetch the contents for a string type even if not requested,
1708      * because we need to compute the length of the ASCII string. */
1709     if (value || data || is_string(info->Type))
1710     {
1711         /* retry with a dynamically allocated buffer */
1712         while (status == STATUS_BUFFER_OVERFLOW)
1713         {
1714             if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
1715             if (!(buf_ptr = HeapAlloc( GetProcessHeap(), 0, total_size )))
1716                 return ERROR_NOT_ENOUGH_MEMORY;
1717             info = (KEY_VALUE_FULL_INFORMATION *)buf_ptr;
1718             status = NtEnumerateValueKey( hkey, index, KeyValueFullInformation,
1719                                           buf_ptr, total_size, &total_size );
1720         }
1721
1722         if (status) goto done;
1723
1724         if (is_string(info->Type))
1725         {
1726             DWORD len;
1727             RtlUnicodeToMultiByteSize( &len, (WCHAR *)(buf_ptr + info->DataOffset),
1728                                        total_size - info->DataOffset );
1729             if (data && len)
1730             {
1731                 if (len > *count) status = STATUS_BUFFER_OVERFLOW;
1732                 else
1733                 {
1734                     RtlUnicodeToMultiByteN( (char*)data, len, NULL, (WCHAR *)(buf_ptr + info->DataOffset),
1735                                             total_size - info->DataOffset );
1736                     /* if the type is REG_SZ and data is not 0-terminated
1737                      * and there is enough space in the buffer NT appends a \0 */
1738                     if (len < *count && data[len-1]) data[len] = 0;
1739                 }
1740             }
1741             info->DataLength = len;
1742         }
1743         else if (data)
1744         {
1745             if (total_size - info->DataOffset > *count) status = STATUS_BUFFER_OVERFLOW;
1746             else memcpy( data, buf_ptr + info->DataOffset, total_size - info->DataOffset );
1747         }
1748
1749         if (value && !status)
1750         {
1751             DWORD len;
1752
1753             RtlUnicodeToMultiByteSize( &len, info->Name, info->NameLength );
1754             if (len >= *val_count)
1755             {
1756                 status = STATUS_BUFFER_OVERFLOW;
1757                 if (*val_count)
1758                 {
1759                     len = *val_count - 1;
1760                     RtlUnicodeToMultiByteN( value, len, NULL, info->Name, info->NameLength );
1761                     value[len] = 0;
1762                 }
1763             }
1764             else
1765             {
1766                 RtlUnicodeToMultiByteN( value, len, NULL, info->Name, info->NameLength );
1767                 value[len] = 0;
1768                 *val_count = len;
1769             }
1770         }
1771     }
1772     else status = STATUS_SUCCESS;
1773
1774     if (type) *type = info->Type;
1775     if (count) *count = info->DataLength;
1776
1777  done:
1778     if (buf_ptr != buffer) HeapFree( GetProcessHeap(), 0, buf_ptr );
1779     return RtlNtStatusToDosError(status);
1780 }
1781
1782
1783
1784 /******************************************************************************
1785  * RegDeleteValueW   [ADVAPI32.@]
1786  *
1787  * See RegDeleteValueA.
1788  */
1789 DWORD WINAPI RegDeleteValueW( HKEY hkey, LPCWSTR name )
1790 {
1791     UNICODE_STRING nameW;
1792
1793     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
1794
1795     RtlInitUnicodeString( &nameW, name );
1796     return RtlNtStatusToDosError( NtDeleteValueKey( hkey, &nameW ) );
1797 }
1798
1799
1800 /******************************************************************************
1801  * RegDeleteValueA   [ADVAPI32.@]
1802  *
1803  * Delete a value from the registry.
1804  *
1805  * PARAMS
1806  *  hkey [I] Registry handle of the key holding the value
1807  *  name [I] Name of the value under hkey to delete
1808  *
1809  * RETURNS
1810  *  Success: ERROR_SUCCESS
1811  *  Failure: nonzero error code from Winerror.h
1812  */
1813 DWORD WINAPI RegDeleteValueA( HKEY hkey, LPCSTR name )
1814 {
1815     STRING nameA;
1816     NTSTATUS status;
1817
1818     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
1819
1820     RtlInitAnsiString( &nameA, name );
1821     if (!(status = RtlAnsiStringToUnicodeString( &NtCurrentTeb()->StaticUnicodeString,
1822                                                  &nameA, FALSE )))
1823         status = NtDeleteValueKey( hkey, &NtCurrentTeb()->StaticUnicodeString );
1824     return RtlNtStatusToDosError( status );
1825 }
1826
1827
1828 /******************************************************************************
1829  * RegLoadKeyW   [ADVAPI32.@]
1830  *
1831  * PARAMS
1832  *  hkey      [I] Handle of open key
1833  *  subkey    [I] Address of name of subkey
1834  *  filename  [I] Address of filename for registry information
1835  *
1836  * RETURNS
1837  *  Success: ERROR_SUCCES
1838  *  Failure: nonzero error code from Winerror.h
1839  */
1840 LONG WINAPI RegLoadKeyW( HKEY hkey, LPCWSTR subkey, LPCWSTR filename )
1841 {
1842     OBJECT_ATTRIBUTES destkey, file;
1843     UNICODE_STRING subkeyW, filenameW;
1844
1845     if (!(hkey = get_special_root_hkey(hkey))) return ERROR_INVALID_HANDLE;
1846
1847     destkey.Length = sizeof(destkey);
1848     destkey.RootDirectory = hkey;               /* root key: HKLM or HKU */
1849     destkey.ObjectName = &subkeyW;              /* name of the key */
1850     destkey.Attributes = 0;
1851     destkey.SecurityDescriptor = NULL;
1852     destkey.SecurityQualityOfService = NULL;
1853     RtlInitUnicodeString(&subkeyW, subkey);
1854
1855     file.Length = sizeof(file);
1856     file.RootDirectory = NULL;
1857     file.ObjectName = &filenameW;               /* file containing the hive */
1858     file.Attributes = OBJ_CASE_INSENSITIVE;
1859     file.SecurityDescriptor = NULL;
1860     file.SecurityQualityOfService = NULL;
1861     RtlDosPathNameToNtPathName_U(filename, &filenameW, NULL, NULL);
1862
1863     return RtlNtStatusToDosError( NtLoadKey(&destkey, &file) );
1864 }
1865
1866
1867 /******************************************************************************
1868  * RegLoadKeyA   [ADVAPI32.@]
1869  *
1870  * see RegLoadKeyW
1871  */
1872 LONG WINAPI RegLoadKeyA( HKEY hkey, LPCSTR subkey, LPCSTR filename )
1873 {
1874     UNICODE_STRING subkeyW, filenameW;
1875     STRING subkeyA, filenameA;
1876     NTSTATUS status;
1877
1878     RtlInitAnsiString(&subkeyA, subkey);
1879     RtlInitAnsiString(&filenameA, filename);
1880
1881     if ((status = RtlAnsiStringToUnicodeString(&subkeyW, &subkeyA, TRUE)))
1882         return RtlNtStatusToDosError(status);
1883
1884     if ((status = RtlAnsiStringToUnicodeString(&filenameW, &filenameA, TRUE)))
1885         return RtlNtStatusToDosError(status);
1886
1887     return RegLoadKeyW(hkey, subkeyW.Buffer, filenameW.Buffer);
1888 }
1889
1890
1891 /******************************************************************************
1892  * RegSaveKeyW   [ADVAPI32.@]
1893  *
1894  * PARAMS
1895  *  hkey   [I] Handle of key where save begins
1896  *  lpFile [I] Address of filename to save to
1897  *  sa     [I] Address of security structure
1898  *
1899  * RETURNS
1900  *  Success: ERROR_SUCCESS
1901  *  Failure: nonzero error code from Winerror.h
1902  */
1903 LONG WINAPI RegSaveKeyW( HKEY hkey, LPCWSTR file, LPSECURITY_ATTRIBUTES sa )
1904 {
1905     static const WCHAR format[] =
1906         {'r','e','g','%','0','4','x','.','t','m','p',0};
1907     WCHAR buffer[MAX_PATH];
1908     int count = 0;
1909     LPWSTR nameW;
1910     DWORD ret, err;
1911     HANDLE handle;
1912
1913     TRACE( "(%p,%s,%p)\n", hkey, debugstr_w(file), sa );
1914
1915     if (!file || !*file) return ERROR_INVALID_PARAMETER;
1916     if (!(hkey = get_special_root_hkey( hkey ))) return ERROR_INVALID_HANDLE;
1917
1918     err = GetLastError();
1919     GetFullPathNameW( file, sizeof(buffer)/sizeof(WCHAR), buffer, &nameW );
1920
1921     for (;;)
1922     {
1923         snprintfW( nameW, 16, format, count++ );
1924         handle = CreateFileW( buffer, GENERIC_WRITE, 0, NULL,
1925                             CREATE_NEW, FILE_ATTRIBUTE_NORMAL, 0 );
1926         if (handle != INVALID_HANDLE_VALUE) break;
1927         if ((ret = GetLastError()) != ERROR_ALREADY_EXISTS) goto done;
1928
1929         /* Something gone haywire ? Please report if this happens abnormally */
1930         if (count >= 100)
1931             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);
1932     }
1933
1934     ret = RtlNtStatusToDosError(NtSaveKey(hkey, handle));
1935
1936     CloseHandle( handle );
1937     if (!ret)
1938     {
1939         if (!MoveFileExW( buffer, file, MOVEFILE_REPLACE_EXISTING ))
1940         {
1941             ERR( "Failed to move %s to %s\n", debugstr_w(buffer),
1942                 debugstr_w(file) );
1943             ret = GetLastError();
1944         }
1945     }
1946     if (ret) DeleteFileW( buffer );
1947
1948 done:
1949     SetLastError( err );  /* restore last error code */
1950     return ret;
1951 }
1952
1953
1954 /******************************************************************************
1955  * RegSaveKeyA  [ADVAPI32.@]
1956  *
1957  * see RegSaveKeyW
1958  */
1959 LONG WINAPI RegSaveKeyA( HKEY hkey, LPCSTR file, LPSECURITY_ATTRIBUTES sa )
1960 {
1961     UNICODE_STRING *fileW = &NtCurrentTeb()->StaticUnicodeString;
1962     NTSTATUS status;
1963     STRING fileA;
1964
1965     RtlInitAnsiString(&fileA, file);
1966     if ((status = RtlAnsiStringToUnicodeString(fileW, &fileA, FALSE)))
1967         return RtlNtStatusToDosError( status );
1968     return RegSaveKeyW(hkey, fileW->Buffer, sa);
1969 }
1970
1971
1972 /******************************************************************************
1973  * RegRestoreKeyW [ADVAPI32.@]
1974  *
1975  * PARAMS
1976  *  hkey    [I] Handle of key where restore begins
1977  *  lpFile  [I] Address of filename containing saved tree
1978  *  dwFlags [I] Optional flags
1979  *
1980  * RETURNS
1981  *  Success: ERROR_SUCCESS
1982  *  Failure: nonzero error code from Winerror.h
1983  */
1984 LONG WINAPI RegRestoreKeyW( HKEY hkey, LPCWSTR lpFile, DWORD dwFlags )
1985 {
1986     TRACE("(%p,%s,%ld)\n",hkey,debugstr_w(lpFile),dwFlags);
1987
1988     /* It seems to do this check before the hkey check */
1989     if (!lpFile || !*lpFile)
1990         return ERROR_INVALID_PARAMETER;
1991
1992     FIXME("(%p,%s,%ld): stub\n",hkey,debugstr_w(lpFile),dwFlags);
1993
1994     /* Check for file existence */
1995
1996     return ERROR_SUCCESS;
1997 }
1998
1999
2000 /******************************************************************************
2001  * RegRestoreKeyA [ADVAPI32.@]
2002  *
2003  * see RegRestoreKeyW
2004  */
2005 LONG WINAPI RegRestoreKeyA( HKEY hkey, LPCSTR lpFile, DWORD dwFlags )
2006 {
2007     UNICODE_STRING lpFileW;
2008     LONG ret;
2009
2010     RtlCreateUnicodeStringFromAsciiz( &lpFileW, lpFile );
2011     ret = RegRestoreKeyW( hkey, lpFileW.Buffer, dwFlags );
2012     RtlFreeUnicodeString( &lpFileW );
2013     return ret;
2014 }
2015
2016
2017 /******************************************************************************
2018  * RegUnLoadKeyW [ADVAPI32.@]
2019  *
2020  * PARAMS
2021  *  hkey     [I] Handle of open key
2022  *  lpSubKey [I] Address of name of subkey to unload
2023  *
2024  * RETURNS
2025  *  Success: ERROR_SUCCESS
2026  *  Failure: nonzero error code from Winerror.h
2027  */
2028 LONG WINAPI RegUnLoadKeyW( HKEY hkey, LPCWSTR lpSubKey )
2029 {
2030     DWORD ret;
2031     HKEY shkey;
2032
2033     TRACE("(%p,%s)\n",hkey, debugstr_w(lpSubKey));
2034
2035     ret = RegOpenKeyW(hkey,lpSubKey,&shkey);
2036     if( ret )
2037         return ERROR_INVALID_PARAMETER;
2038
2039     ret = RtlNtStatusToDosError(NtUnloadKey(shkey));
2040
2041     RegCloseKey(shkey);
2042
2043     return ret;
2044 }
2045
2046
2047 /******************************************************************************
2048  * RegUnLoadKeyA [ADVAPI32.@]
2049  *
2050  * see RegUnLoadKeyW
2051  */
2052 LONG WINAPI RegUnLoadKeyA( HKEY hkey, LPCSTR lpSubKey )
2053 {
2054     UNICODE_STRING lpSubKeyW;
2055     LONG ret;
2056
2057     RtlCreateUnicodeStringFromAsciiz( &lpSubKeyW, lpSubKey );
2058     ret = RegUnLoadKeyW( hkey, lpSubKeyW.Buffer );
2059     RtlFreeUnicodeString( &lpSubKeyW );
2060     return ret;
2061 }
2062
2063
2064 /******************************************************************************
2065  * RegReplaceKeyW [ADVAPI32.@]
2066  *
2067  * PARAMS
2068  *  hkey      [I] Handle of open key
2069  *  lpSubKey  [I] Address of name of subkey
2070  *  lpNewFile [I] Address of filename for file with new data
2071  *  lpOldFile [I] Address of filename for backup file
2072  *
2073  * RETURNS
2074  *  Success: ERROR_SUCCESS
2075  *  Failure: nonzero error code from Winerror.h
2076  */
2077 LONG WINAPI RegReplaceKeyW( HKEY hkey, LPCWSTR lpSubKey, LPCWSTR lpNewFile,
2078                               LPCWSTR lpOldFile )
2079 {
2080     FIXME("(%p,%s,%s,%s): stub\n", hkey, debugstr_w(lpSubKey),
2081           debugstr_w(lpNewFile),debugstr_w(lpOldFile));
2082     return ERROR_SUCCESS;
2083 }
2084
2085
2086 /******************************************************************************
2087  * RegReplaceKeyA [ADVAPI32.@]
2088  *
2089  * see RegReplaceKeyW
2090  */
2091 LONG WINAPI RegReplaceKeyA( HKEY hkey, LPCSTR lpSubKey, LPCSTR lpNewFile,
2092                               LPCSTR lpOldFile )
2093 {
2094     UNICODE_STRING lpSubKeyW;
2095     UNICODE_STRING lpNewFileW;
2096     UNICODE_STRING lpOldFileW;
2097     LONG ret;
2098
2099     RtlCreateUnicodeStringFromAsciiz( &lpSubKeyW, lpSubKey );
2100     RtlCreateUnicodeStringFromAsciiz( &lpOldFileW, lpOldFile );
2101     RtlCreateUnicodeStringFromAsciiz( &lpNewFileW, lpNewFile );
2102     ret = RegReplaceKeyW( hkey, lpSubKeyW.Buffer, lpNewFileW.Buffer, lpOldFileW.Buffer );
2103     RtlFreeUnicodeString( &lpOldFileW );
2104     RtlFreeUnicodeString( &lpNewFileW );
2105     RtlFreeUnicodeString( &lpSubKeyW );
2106     return ret;
2107 }
2108
2109
2110 /******************************************************************************
2111  * RegSetKeySecurity [ADVAPI32.@]
2112  *
2113  * PARAMS
2114  *  hkey          [I] Open handle of key to set
2115  *  SecurityInfo  [I] Descriptor contents
2116  *  pSecurityDesc [I] Address of descriptor for key
2117  *
2118  * RETURNS
2119  *  Success: ERROR_SUCCESS
2120  *  Failure: nonzero error code from Winerror.h
2121  */
2122 LONG WINAPI RegSetKeySecurity( HKEY hkey, SECURITY_INFORMATION SecurityInfo,
2123                                PSECURITY_DESCRIPTOR pSecurityDesc )
2124 {
2125     TRACE("(%p,%ld,%p)\n",hkey,SecurityInfo,pSecurityDesc);
2126
2127     /* It seems to perform this check before the hkey check */
2128     if ((SecurityInfo & OWNER_SECURITY_INFORMATION) ||
2129         (SecurityInfo & GROUP_SECURITY_INFORMATION) ||
2130         (SecurityInfo & DACL_SECURITY_INFORMATION) ||
2131         (SecurityInfo & SACL_SECURITY_INFORMATION)) {
2132         /* Param OK */
2133     } else
2134         return ERROR_INVALID_PARAMETER;
2135
2136     if (!pSecurityDesc)
2137         return ERROR_INVALID_PARAMETER;
2138
2139     FIXME(":(%p,%ld,%p): stub\n",hkey,SecurityInfo,pSecurityDesc);
2140
2141     return ERROR_SUCCESS;
2142 }
2143
2144
2145 /******************************************************************************
2146  * RegGetKeySecurity [ADVAPI32.@]
2147  *
2148  * Get a copy of the security descriptor for a given registry key.
2149  *
2150  * PARAMS
2151  *  hkey                   [I]   Open handle of key to set
2152  *  SecurityInformation    [I]   Descriptor contents
2153  *  pSecurityDescriptor    [O]   Address of descriptor for key
2154  *  lpcbSecurityDescriptor [I/O] Address of size of buffer and description
2155  *
2156  * RETURNS
2157  *  Success: ERROR_SUCCESS
2158  *  Failure: Error code
2159  */
2160 LONG WINAPI RegGetKeySecurity( HKEY hkey, SECURITY_INFORMATION SecurityInformation,
2161                                PSECURITY_DESCRIPTOR pSecurityDescriptor,
2162                                LPDWORD lpcbSecurityDescriptor )
2163 {
2164     TRACE("(%p,%ld,%p,%ld)\n",hkey,SecurityInformation,pSecurityDescriptor,
2165           lpcbSecurityDescriptor?*lpcbSecurityDescriptor:0);
2166
2167     /* FIXME: Check for valid SecurityInformation values */
2168
2169     if (*lpcbSecurityDescriptor < sizeof(SECURITY_DESCRIPTOR))
2170         return ERROR_INSUFFICIENT_BUFFER;
2171
2172     FIXME("(%p,%ld,%p,%ld): stub\n",hkey,SecurityInformation,
2173           pSecurityDescriptor,lpcbSecurityDescriptor?*lpcbSecurityDescriptor:0);
2174
2175     /* Do not leave security descriptor filled with garbage */
2176     RtlCreateSecurityDescriptor(pSecurityDescriptor, SECURITY_DESCRIPTOR_REVISION);
2177
2178     return ERROR_SUCCESS;
2179 }
2180
2181
2182 /******************************************************************************
2183  * RegFlushKey [ADVAPI32.@]
2184  *
2185  * Immediately write a registry key to registry.
2186  *
2187  * PARAMS
2188  *  hkey [I] Handle of key to write
2189  *
2190  * RETURNS
2191  *  Success: ERROR_SUCCESS
2192  *  Failure: Error code
2193  */
2194 DWORD WINAPI RegFlushKey( HKEY hkey )
2195 {
2196     hkey = get_special_root_hkey( hkey );
2197     if (!hkey) return ERROR_INVALID_HANDLE;
2198
2199     return RtlNtStatusToDosError( NtFlushKey( hkey ) );
2200 }
2201
2202
2203 /******************************************************************************
2204  * RegConnectRegistryW [ADVAPI32.@]
2205  *
2206  * PARAMS
2207  *  lpMachineName [I] Address of name of remote computer
2208  *  hHey          [I] Predefined registry handle
2209  *  phkResult     [I] Address of buffer for remote registry handle
2210  *
2211  * RETURNS
2212  *  Success: ERROR_SUCCESS
2213  *  Failure: nonzero error code from Winerror.h
2214  */
2215 LONG WINAPI RegConnectRegistryW( LPCWSTR lpMachineName, HKEY hKey,
2216                                    PHKEY phkResult )
2217 {
2218     LONG ret;
2219
2220     TRACE("(%s,%p,%p): stub\n",debugstr_w(lpMachineName),hKey,phkResult);
2221
2222     if (!lpMachineName || !*lpMachineName) {
2223         /* Use the local machine name */
2224         ret = RegOpenKeyW( hKey, NULL, phkResult );
2225     }
2226     else if (lpMachineName[0] != '\\' || lpMachineName[1] != '\\')
2227         ret = ERROR_BAD_NETPATH;
2228     else
2229     {
2230         WCHAR compName[MAX_COMPUTERNAME_LENGTH + 1];
2231         DWORD len = sizeof(compName) / sizeof(WCHAR);
2232
2233         if (GetComputerNameW(compName, &len))
2234         {
2235             if (!strcmpiW(lpMachineName + 2, compName))
2236                 ret = RegOpenKeyW(hKey, NULL, phkResult);
2237             else
2238             {
2239                 FIXME("Cannot connect to %s\n",debugstr_w(lpMachineName));
2240                 ret = ERROR_BAD_NETPATH;
2241             }
2242         }
2243         else
2244             ret = GetLastError();
2245     }
2246     return ret;
2247 }
2248
2249
2250 /******************************************************************************
2251  * RegConnectRegistryA [ADVAPI32.@]
2252  *
2253  * see RegConnectRegistryW
2254  */
2255 LONG WINAPI RegConnectRegistryA( LPCSTR machine, HKEY hkey, PHKEY reskey )
2256 {
2257     UNICODE_STRING machineW;
2258     LONG ret;
2259
2260     RtlCreateUnicodeStringFromAsciiz( &machineW, machine );
2261     ret = RegConnectRegistryW( machineW.Buffer, hkey, reskey );
2262     RtlFreeUnicodeString( &machineW );
2263     return ret;
2264 }
2265
2266
2267 /******************************************************************************
2268  * RegNotifyChangeKeyValue [ADVAPI32.@]
2269  *
2270  * PARAMS
2271  *  hkey            [I] Handle of key to watch
2272  *  fWatchSubTree   [I] Flag for subkey notification
2273  *  fdwNotifyFilter [I] Changes to be reported
2274  *  hEvent          [I] Handle of signaled event
2275  *  fAsync          [I] Flag for asynchronous reporting
2276  *
2277  * RETURNS
2278  *  Success: ERROR_SUCCESS
2279  *  Failure: nonzero error code from Winerror.h
2280  */
2281 LONG WINAPI RegNotifyChangeKeyValue( HKEY hkey, BOOL fWatchSubTree,
2282                                      DWORD fdwNotifyFilter, HANDLE hEvent,
2283                                      BOOL fAsync )
2284 {
2285     NTSTATUS status;
2286     IO_STATUS_BLOCK iosb;
2287
2288     hkey = get_special_root_hkey( hkey );
2289     if (!hkey) return ERROR_INVALID_HANDLE;
2290
2291     TRACE("(%p,%i,%ld,%p,%i)\n", hkey, fWatchSubTree, fdwNotifyFilter,
2292           hEvent, fAsync);
2293
2294     status = NtNotifyChangeKey( hkey, hEvent, NULL, NULL, &iosb,
2295                                 fdwNotifyFilter, fWatchSubTree, NULL, 0,
2296                                 fAsync );
2297
2298     if (status && status != STATUS_TIMEOUT)
2299         return RtlNtStatusToDosError( status );
2300
2301     return ERROR_SUCCESS;
2302 }
2303
2304 /******************************************************************************
2305  * RegOpenUserClassesRoot [ADVAPI32.@]
2306  *
2307  * Open the HKEY_CLASSES_ROOT key for a user.
2308  *
2309  * PARAMS
2310  *  hToken     [I] Handle of token representing the user
2311  *  dwOptions  [I] Reserved, nust be 0
2312  *  samDesired [I] Desired access rights
2313  *  phkResult  [O] Destination for the resulting key handle
2314  *
2315  * RETURNS
2316  *  Success: ERROR_SUCCESS
2317  *  Failure: nonzero error code from Winerror.h
2318  *
2319  * NOTES
2320  *  On Windows 2000 and upwards the HKEY_CLASSES_ROOT key is a view of the
2321  *  "HKEY_LOCAL_MACHINE\Software\Classes" and the
2322  *  "HKEY_CURRENT_USER\Software\Classes" keys merged together.
2323  */
2324 LONG WINAPI RegOpenUserClassesRoot(
2325     HANDLE hToken,
2326     DWORD dwOptions,
2327     REGSAM samDesired,
2328     PHKEY phkResult
2329 )
2330 {
2331     FIXME("(%p, 0x%lx, 0x%lx, %p) semi-stub\n", hToken, dwOptions, samDesired, phkResult);
2332
2333     *phkResult = HKEY_CLASSES_ROOT;
2334     return ERROR_SUCCESS;
2335 }