2 * COPYRIGHT: See COPYING in the top level directory
3 * PROJECT: ReactOS system libraries
4 * FILE: lib/advapi32/reg/reg.c
5 * PURPOSE: Registry functions
6 * PROGRAMMER: Ariadne ( ariadne@xs4all.nl)
7 * Thomas Weidenmueller <w3seek@reactos.com>
11 * 20050502 Fireball imported some stuff from WINE
14 /* INCLUDES *****************************************************************/
18 #include <ndk/cmfuncs.h>
19 #include <pseh/pseh2.h>
23 WINE_DEFAULT_DEBUG_CHANNEL(reg
);
25 /* DEFINES ******************************************************************/
27 #define MAX_DEFAULT_HANDLES 6
28 #define REG_MAX_NAME_SIZE 256
29 #define REG_MAX_DATA_SIZE 2048
31 /* GLOBALS ******************************************************************/
33 static RTL_CRITICAL_SECTION HandleTableCS
;
34 static HANDLE DefaultHandleTable
[MAX_DEFAULT_HANDLES
];
35 static HANDLE ProcessHeap
;
36 static BOOLEAN DefaultHandlesDisabled
= FALSE
;
37 static BOOLEAN DefaultHandleHKUDisabled
= FALSE
;
38 static BOOLEAN DllInitialized
= FALSE
; /* HACK */
40 /* PROTOTYPES ***************************************************************/
42 static NTSTATUS
MapDefaultKey (PHANDLE ParentKey
, HKEY Key
);
43 static VOID
CloseDefaultKeys(VOID
);
44 #define ClosePredefKey(Handle) \
45 if ((ULONG_PTR)Handle & 0x1) { \
48 #define IsPredefKey(HKey) \
49 (((ULONG_PTR)(HKey) & 0xF0000000) == 0x80000000)
50 #define GetPredefKeyIndex(HKey) \
51 ((ULONG_PTR)(HKey) & 0x0FFFFFFF)
53 static NTSTATUS
OpenClassesRootKey(PHANDLE KeyHandle
);
54 static NTSTATUS
OpenLocalMachineKey (PHANDLE KeyHandle
);
55 static NTSTATUS
OpenUsersKey (PHANDLE KeyHandle
);
56 static NTSTATUS
OpenCurrentConfigKey(PHANDLE KeyHandle
);
59 /* FUNCTIONS ****************************************************************/
60 /* check if value type needs string conversion (Ansi<->Unicode) */
61 __inline
static int is_string( DWORD type
)
63 return (type
== REG_SZ
) || (type
== REG_EXPAND_SZ
) || (type
== REG_MULTI_SZ
);
66 /************************************************************************
67 * RegInitDefaultHandles
72 TRACE("RegInitialize()\n");
77 ProcessHeap
= RtlGetProcessHeap();
78 RtlZeroMemory(DefaultHandleTable
,
79 MAX_DEFAULT_HANDLES
* sizeof(HANDLE
));
80 RtlInitializeCriticalSection(&HandleTableCS
);
82 DllInitialized
= TRUE
;
89 /************************************************************************
95 TRACE("RegCleanup()\n");
98 RtlDeleteCriticalSection(&HandleTableCS
);
105 OpenPredefinedKey(IN ULONG Index
,
112 case 0: /* HKEY_CLASSES_ROOT */
113 Status
= OpenClassesRootKey (Handle
);
116 case 1: /* HKEY_CURRENT_USER */
117 Status
= RtlOpenCurrentUser (MAXIMUM_ALLOWED
,
121 case 2: /* HKEY_LOCAL_MACHINE */
122 Status
= OpenLocalMachineKey (Handle
);
125 case 3: /* HKEY_USERS */
126 Status
= OpenUsersKey (Handle
);
129 case 4: /* HKEY_PERFORMANCE_DATA */
130 Status
= OpenPerformanceDataKey (Handle
);
134 case 5: /* HKEY_CURRENT_CONFIG */
135 Status
= OpenCurrentConfigKey (Handle
);
138 case 6: /* HKEY_DYN_DATA */
139 Status
= STATUS_NOT_IMPLEMENTED
;
143 WARN("MapDefaultHandle() no handle creator\n");
144 Status
= STATUS_INVALID_PARAMETER
;
153 MapDefaultKey(OUT PHANDLE RealKey
,
158 BOOLEAN DoOpen
, DefDisabled
;
159 NTSTATUS Status
= STATUS_SUCCESS
;
161 TRACE("MapDefaultKey (Key %x)\n", Key
);
163 if (!IsPredefKey(Key
))
165 *RealKey
= (HANDLE
)((ULONG_PTR
)Key
& ~0x1);
166 return STATUS_SUCCESS
;
169 /* Handle special cases here */
170 Index
= GetPredefKeyIndex(Key
);
171 if (Index
>= MAX_DEFAULT_HANDLES
)
173 return STATUS_INVALID_PARAMETER
;
175 RegInitialize(); /* HACK until delay-loading is implemented */
176 RtlEnterCriticalSection (&HandleTableCS
);
178 if (Key
== HKEY_CURRENT_USER
)
179 DefDisabled
= DefaultHandleHKUDisabled
;
181 DefDisabled
= DefaultHandlesDisabled
;
185 Handle
= &DefaultHandleTable
[Index
];
186 DoOpen
= (*Handle
== NULL
);
196 /* create/open the default handle */
197 Status
= OpenPredefinedKey(Index
,
201 if (NT_SUCCESS(Status
))
206 *(PULONG_PTR
)Handle
|= 0x1;
209 RtlLeaveCriticalSection (&HandleTableCS
);
216 CloseDefaultKeys(VOID
)
219 RegInitialize(); /* HACK until delay-loading is implemented */
220 RtlEnterCriticalSection(&HandleTableCS
);
222 for (i
= 0; i
< MAX_DEFAULT_HANDLES
; i
++)
224 if (DefaultHandleTable
[i
] != NULL
)
226 NtClose(DefaultHandleTable
[i
]);
227 DefaultHandleTable
[i
] = NULL
;
231 RtlLeaveCriticalSection(&HandleTableCS
);
236 OpenClassesRootKey(_Out_ PHANDLE KeyHandle
)
238 OBJECT_ATTRIBUTES Attributes
;
239 UNICODE_STRING KeyName
= RTL_CONSTANT_STRING(L
"\\Registry\\Machine\\Software\\CLASSES");
242 TRACE("OpenClassesRootKey()\n");
244 InitializeObjectAttributes(&Attributes
,
246 OBJ_CASE_INSENSITIVE
,
249 Status
= NtOpenKey(KeyHandle
,
253 if (!NT_SUCCESS(Status
))
256 /* Mark it as HKCR */
257 MakeHKCRKey((HKEY
*)KeyHandle
);
264 OpenLocalMachineKey(PHANDLE KeyHandle
)
266 OBJECT_ATTRIBUTES Attributes
;
267 UNICODE_STRING KeyName
= RTL_CONSTANT_STRING(L
"\\Registry\\Machine");
270 TRACE("OpenLocalMachineKey()\n");
272 InitializeObjectAttributes(&Attributes
,
274 OBJ_CASE_INSENSITIVE
,
277 Status
= NtOpenKey(KeyHandle
,
281 TRACE("NtOpenKey(%wZ) => %08x\n", &KeyName
, Status
);
288 OpenUsersKey(PHANDLE KeyHandle
)
290 OBJECT_ATTRIBUTES Attributes
;
291 UNICODE_STRING KeyName
= RTL_CONSTANT_STRING(L
"\\Registry\\User");
293 TRACE("OpenUsersKey()\n");
295 InitializeObjectAttributes(&Attributes
,
297 OBJ_CASE_INSENSITIVE
,
300 return NtOpenKey(KeyHandle
,
307 OpenCurrentConfigKey (PHANDLE KeyHandle
)
309 OBJECT_ATTRIBUTES Attributes
;
310 UNICODE_STRING KeyName
=
311 RTL_CONSTANT_STRING(L
"\\Registry\\Machine\\System\\CurrentControlSet\\Hardware Profiles\\Current");
313 TRACE("OpenCurrentConfigKey()\n");
315 InitializeObjectAttributes(&Attributes
,
317 OBJ_CASE_INSENSITIVE
,
320 return NtOpenKey(KeyHandle
,
326 /************************************************************************
327 * RegDisablePredefinedCache
332 RegDisablePredefinedCache(VOID
)
334 RegInitialize(); /* HACK until delay-loading is implemented */
335 RtlEnterCriticalSection(&HandleTableCS
);
336 DefaultHandleHKUDisabled
= TRUE
;
337 RtlLeaveCriticalSection(&HandleTableCS
);
338 return ERROR_SUCCESS
;
342 /************************************************************************
343 * RegDisablePredefinedCacheEx
348 RegDisablePredefinedCacheEx(VOID
)
350 RegInitialize(); /* HACK until delay-loading is implemented */
351 RtlEnterCriticalSection(&HandleTableCS
);
352 DefaultHandlesDisabled
= TRUE
;
353 DefaultHandleHKUDisabled
= TRUE
;
354 RtlLeaveCriticalSection(&HandleTableCS
);
355 return ERROR_SUCCESS
;
359 /************************************************************************
360 * RegOverridePredefKey
365 RegOverridePredefKey(IN HKEY hKey
,
366 IN HKEY hNewHKey OPTIONAL
)
368 LONG ErrorCode
= ERROR_SUCCESS
;
370 if ((hKey
== HKEY_CLASSES_ROOT
||
371 hKey
== HKEY_CURRENT_CONFIG
||
372 hKey
== HKEY_CURRENT_USER
||
373 hKey
== HKEY_LOCAL_MACHINE
||
374 hKey
== HKEY_PERFORMANCE_DATA
||
375 hKey
== HKEY_USERS
) &&
376 !IsPredefKey(hNewHKey
))
381 Index
= GetPredefKeyIndex(hKey
);
382 Handle
= &DefaultHandleTable
[Index
];
384 if (hNewHKey
== NULL
)
386 /* restore the default mapping */
387 NTSTATUS Status
= OpenPredefinedKey(Index
,
389 if (!NT_SUCCESS(Status
))
391 return RtlNtStatusToDosError(Status
);
394 ASSERT(hNewHKey
!= NULL
);
396 RegInitialize(); /* HACK until delay-loading is implemented */
397 RtlEnterCriticalSection(&HandleTableCS
);
399 /* close the currently mapped handle if existing */
405 /* update the mapping */
408 RtlLeaveCriticalSection(&HandleTableCS
);
411 ErrorCode
= ERROR_INVALID_HANDLE
;
417 /************************************************************************
423 RegCloseKey(HKEY hKey
)
427 /* don't close null handle or a pseudo handle */
428 if ((!hKey
) || (((ULONG_PTR
)hKey
& 0xF0000000) == 0x80000000))
430 return ERROR_INVALID_HANDLE
;
433 Status
= NtClose(hKey
);
434 if (!NT_SUCCESS(Status
))
436 return RtlNtStatusToDosError(Status
);
439 return ERROR_SUCCESS
;
444 RegpCopyTree(IN HKEY hKeySrc
,
449 LIST_ENTRY ListEntry
;
452 } REGP_COPY_KEYS
, *PREGP_COPY_KEYS
;
454 LIST_ENTRY copyQueueHead
;
455 PREGP_COPY_KEYS copyKeys
, newCopyKeys
;
458 KEY_VALUE_FULL_INFORMATION
*KeyValue
;
459 KEY_NODE_INFORMATION
*KeyNode
;
462 ULONG Index
, BufferSizeRequired
, BufferSize
= 0x200;
463 NTSTATUS Status
= STATUS_SUCCESS
;
464 NTSTATUS Status2
= STATUS_SUCCESS
;
466 InitializeListHead(©QueueHead
);
468 Info
.Buffer
= RtlAllocateHeap(ProcessHeap
,
471 if (Info
.Buffer
== NULL
)
473 return STATUS_INSUFFICIENT_RESOURCES
;
476 copyKeys
= RtlAllocateHeap(ProcessHeap
,
478 sizeof(REGP_COPY_KEYS
));
479 if (copyKeys
!= NULL
)
481 copyKeys
->hKeySrc
= hKeySrc
;
482 copyKeys
->hKeyDest
= hKeyDest
;
483 InsertHeadList(©QueueHead
,
484 ©Keys
->ListEntry
);
486 /* FIXME - copy security from hKeySrc to hKeyDest or just for the subkeys? */
490 copyKeys
= CONTAINING_RECORD(copyQueueHead
.Flink
,
494 /* enumerate all values and copy them */
498 Status2
= NtEnumerateValueKey(copyKeys
->hKeySrc
,
500 KeyValueFullInformation
,
503 &BufferSizeRequired
);
504 if (NT_SUCCESS(Status2
))
506 UNICODE_STRING ValueName
;
509 /* don't use RtlInitUnicodeString as the string is not NULL-terminated! */
510 ValueName
.Length
= Info
.KeyValue
->NameLength
;
511 ValueName
.MaximumLength
= ValueName
.Length
;
512 ValueName
.Buffer
= Info
.KeyValue
->Name
;
514 Data
= (PVOID
)((ULONG_PTR
)Info
.KeyValue
+ Info
.KeyValue
->DataOffset
);
516 Status2
= NtSetValueKey(copyKeys
->hKeyDest
,
518 Info
.KeyValue
->TitleIndex
,
521 Info
.KeyValue
->DataLength
);
523 /* don't break, let's try to copy as many values as possible */
524 if (!NT_SUCCESS(Status2
) && NT_SUCCESS(Status
))
531 else if (Status2
== STATUS_BUFFER_OVERFLOW
)
535 ASSERT(BufferSize
< BufferSizeRequired
);
537 Buffer
= RtlReAllocateHeap(ProcessHeap
,
543 Info
.Buffer
= Buffer
;
548 /* don't break, let's try to copy as many values as possible */
549 Status2
= STATUS_INSUFFICIENT_RESOURCES
;
552 if (NT_SUCCESS(Status
))
560 /* break to avoid an infinite loop in case of denied access or
562 if (Status2
!= STATUS_NO_MORE_ENTRIES
&& NT_SUCCESS(Status
))
571 /* enumerate all subkeys and open and enqueue them */
575 Status2
= NtEnumerateKey(copyKeys
->hKeySrc
,
580 &BufferSizeRequired
);
581 if (NT_SUCCESS(Status2
))
583 HANDLE KeyHandle
, NewKeyHandle
;
584 OBJECT_ATTRIBUTES ObjectAttributes
;
585 UNICODE_STRING SubKeyName
, ClassName
;
587 /* don't use RtlInitUnicodeString as the string is not NULL-terminated! */
588 SubKeyName
.Length
= Info
.KeyNode
->NameLength
;
589 SubKeyName
.MaximumLength
= SubKeyName
.Length
;
590 SubKeyName
.Buffer
= Info
.KeyNode
->Name
;
591 ClassName
.Length
= Info
.KeyNode
->ClassLength
;
592 ClassName
.MaximumLength
= ClassName
.Length
;
593 ClassName
.Buffer
= (PWSTR
)((ULONG_PTR
)Info
.KeyNode
+ Info
.KeyNode
->ClassOffset
);
595 /* open the subkey with sufficient rights */
597 InitializeObjectAttributes(&ObjectAttributes
,
599 OBJ_CASE_INSENSITIVE
,
603 Status2
= NtOpenKey(&KeyHandle
,
604 KEY_ENUMERATE_SUB_KEYS
| KEY_QUERY_VALUE
,
606 if (NT_SUCCESS(Status2
))
608 /* FIXME - attempt to query the security information */
610 InitializeObjectAttributes(&ObjectAttributes
,
612 OBJ_CASE_INSENSITIVE
,
616 Status2
= NtCreateKey(&NewKeyHandle
,
619 Info
.KeyNode
->TitleIndex
,
623 if (NT_SUCCESS(Status2
))
625 newCopyKeys
= RtlAllocateHeap(ProcessHeap
,
627 sizeof(REGP_COPY_KEYS
));
628 if (newCopyKeys
!= NULL
)
630 /* save the handles and enqueue the subkey */
631 newCopyKeys
->hKeySrc
= KeyHandle
;
632 newCopyKeys
->hKeyDest
= NewKeyHandle
;
633 InsertTailList(©QueueHead
,
634 &newCopyKeys
->ListEntry
);
639 NtClose(NewKeyHandle
);
641 Status2
= STATUS_INSUFFICIENT_RESOURCES
;
650 if (!NT_SUCCESS(Status2
) && NT_SUCCESS(Status
))
657 else if (Status2
== STATUS_BUFFER_OVERFLOW
)
661 ASSERT(BufferSize
< BufferSizeRequired
);
663 Buffer
= RtlReAllocateHeap(ProcessHeap
,
669 Info
.Buffer
= Buffer
;
674 /* don't break, let's try to copy as many keys as possible */
675 Status2
= STATUS_INSUFFICIENT_RESOURCES
;
678 if (NT_SUCCESS(Status
))
686 /* break to avoid an infinite loop in case of denied access or
688 if (Status2
!= STATUS_NO_MORE_ENTRIES
&& NT_SUCCESS(Status
))
697 /* close the handles and remove the entry from the list */
698 if (copyKeys
->hKeySrc
!= hKeySrc
)
700 NtClose(copyKeys
->hKeySrc
);
702 if (copyKeys
->hKeyDest
!= hKeyDest
)
704 NtClose(copyKeys
->hKeyDest
);
707 RemoveEntryList(©Keys
->ListEntry
);
709 RtlFreeHeap(ProcessHeap
,
712 } while (!IsListEmpty(©QueueHead
));
715 Status
= STATUS_INSUFFICIENT_RESOURCES
;
717 RtlFreeHeap(ProcessHeap
,
725 /************************************************************************
731 RegCopyTreeW(IN HKEY hKeySrc
,
732 IN LPCWSTR lpSubKey OPTIONAL
,
735 HANDLE DestKeyHandle
, KeyHandle
, CurKey
, SubKeyHandle
= NULL
;
738 Status
= MapDefaultKey(&KeyHandle
,
740 if (!NT_SUCCESS(Status
))
742 return RtlNtStatusToDosError(Status
);
745 Status
= MapDefaultKey(&DestKeyHandle
,
747 if (!NT_SUCCESS(Status
))
752 if (lpSubKey
!= NULL
)
754 OBJECT_ATTRIBUTES ObjectAttributes
;
755 UNICODE_STRING SubKeyName
;
757 RtlInitUnicodeString(&SubKeyName
,
760 InitializeObjectAttributes(&ObjectAttributes
,
762 OBJ_CASE_INSENSITIVE
,
766 Status
= NtOpenKey(&SubKeyHandle
,
767 KEY_ENUMERATE_SUB_KEYS
| KEY_QUERY_VALUE
,
769 if (!NT_SUCCESS(Status
))
774 CurKey
= SubKeyHandle
;
779 Status
= RegpCopyTree(CurKey
,
782 if (SubKeyHandle
!= NULL
)
784 NtClose(SubKeyHandle
);
788 ClosePredefKey(DestKeyHandle
);
790 ClosePredefKey(KeyHandle
);
792 if (!NT_SUCCESS(Status
))
794 return RtlNtStatusToDosError(Status
);
797 return ERROR_SUCCESS
;
801 /************************************************************************
807 RegCopyTreeA(IN HKEY hKeySrc
,
808 IN LPCSTR lpSubKey OPTIONAL
,
811 UNICODE_STRING SubKeyName
= { 0, 0, NULL
};
814 if (lpSubKey
!= NULL
&&
815 !RtlCreateUnicodeStringFromAsciiz(&SubKeyName
,
818 return ERROR_NOT_ENOUGH_MEMORY
;
821 Ret
= RegCopyTreeW(hKeySrc
,
825 RtlFreeUnicodeString(&SubKeyName
);
831 /************************************************************************
832 * RegConnectRegistryA
837 RegConnectRegistryA(IN LPCSTR lpMachineName
,
841 UNICODE_STRING MachineName
= { 0, 0, NULL
};
844 if (lpMachineName
!= NULL
&&
845 !RtlCreateUnicodeStringFromAsciiz(&MachineName
,
846 (LPSTR
)lpMachineName
))
848 return ERROR_NOT_ENOUGH_MEMORY
;
851 Ret
= RegConnectRegistryW(MachineName
.Buffer
,
855 RtlFreeUnicodeString(&MachineName
);
861 /************************************************************************
862 * RegConnectRegistryW
867 RegConnectRegistryW(LPCWSTR lpMachineName
,
873 TRACE("(%s,%p,%p): stub\n",debugstr_w(lpMachineName
),hKey
,phkResult
);
875 if (!lpMachineName
|| !*lpMachineName
)
877 /* Use the local machine name */
878 ret
= RegOpenKeyW( hKey
, NULL
, phkResult
);
882 WCHAR compName
[MAX_COMPUTERNAME_LENGTH
+ 1];
883 DWORD len
= sizeof(compName
) / sizeof(WCHAR
);
885 /* MSDN says lpMachineName must start with \\ : not so */
886 if( lpMachineName
[0] == '\\' && lpMachineName
[1] == '\\')
889 if (GetComputerNameW(compName
, &len
))
891 if (!_wcsicmp(lpMachineName
, compName
))
892 ret
= RegOpenKeyW(hKey
, NULL
, phkResult
);
895 FIXME("Connect to %s is not supported.\n",debugstr_w(lpMachineName
));
896 ret
= ERROR_BAD_NETPATH
;
900 ret
= GetLastError();
907 /************************************************************************
910 * Create key and all necessary intermediate keys
913 CreateNestedKey(PHKEY KeyHandle
,
914 POBJECT_ATTRIBUTES ObjectAttributes
,
915 PUNICODE_STRING ClassString
,
918 DWORD
*lpdwDisposition
)
920 OBJECT_ATTRIBUTES LocalObjectAttributes
;
921 UNICODE_STRING LocalKeyName
;
924 ULONG FullNameLength
;
927 HANDLE LocalKeyHandle
;
929 Status
= NtCreateKey((PHANDLE
) KeyHandle
,
935 (PULONG
)lpdwDisposition
);
936 TRACE("NtCreateKey(%wZ) called (Status %lx)\n", ObjectAttributes
->ObjectName
, Status
);
937 if (Status
!= STATUS_OBJECT_NAME_NOT_FOUND
)
940 /* Copy object attributes */
941 RtlCopyMemory(&LocalObjectAttributes
,
943 sizeof(OBJECT_ATTRIBUTES
));
944 RtlCreateUnicodeString(&LocalKeyName
,
945 ObjectAttributes
->ObjectName
->Buffer
);
946 LocalObjectAttributes
.ObjectName
= &LocalKeyName
;
947 FullNameLength
= LocalKeyName
.Length
/ sizeof(WCHAR
);
949 LocalKeyHandle
= NULL
;
951 /* Remove the last part of the key name and try to create the key again. */
952 while (Status
== STATUS_OBJECT_NAME_NOT_FOUND
)
954 Ptr
= wcsrchr(LocalKeyName
.Buffer
, '\\');
955 if (Ptr
== NULL
|| Ptr
== LocalKeyName
.Buffer
)
957 Status
= STATUS_UNSUCCESSFUL
;
962 LocalKeyName
.Length
= wcslen(LocalKeyName
.Buffer
) * sizeof(WCHAR
);
964 Status
= NtCreateKey(&LocalKeyHandle
,
966 &LocalObjectAttributes
,
971 TRACE("NtCreateKey(%wZ) called (Status %lx)\n", &LocalKeyName
, Status
);
974 if (!NT_SUCCESS(Status
))
976 RtlFreeUnicodeString(&LocalKeyName
);
980 /* Add removed parts of the key name and create them too. */
981 Length
= wcslen(LocalKeyName
.Buffer
);
985 NtClose (LocalKeyHandle
);
987 LocalKeyName
.Buffer
[Length
] = L
'\\';
988 Length
= wcslen (LocalKeyName
.Buffer
);
989 LocalKeyName
.Length
= Length
* sizeof(WCHAR
);
991 if (Length
== FullNameLength
)
993 Status
= NtCreateKey((PHANDLE
) KeyHandle
,
999 (PULONG
)lpdwDisposition
);
1003 Status
= NtCreateKey(&LocalKeyHandle
,
1005 &LocalObjectAttributes
,
1010 TRACE("NtCreateKey(%wZ) called (Status %lx)\n", &LocalKeyName
, Status
);
1011 if (!NT_SUCCESS(Status
))
1015 RtlFreeUnicodeString(&LocalKeyName
);
1021 /************************************************************************
1029 _In_ LPCSTR lpSubKey
,
1030 _In_ DWORD Reserved
,
1032 _In_ DWORD dwOptions
,
1033 _In_ REGSAM samDesired
,
1034 _In_ LPSECURITY_ATTRIBUTES lpSecurityAttributes
,
1035 _Out_ PHKEY phkResult
,
1036 _Out_ LPDWORD lpdwDisposition
)
1038 UNICODE_STRING SubKeyString
;
1039 UNICODE_STRING ClassString
;
1042 RtlInitEmptyUnicodeString(&ClassString
, NULL
, 0);
1043 RtlInitEmptyUnicodeString(&SubKeyString
, NULL
, 0);
1047 if (!RtlCreateUnicodeStringFromAsciiz(&ClassString
, lpClass
))
1049 ErrorCode
= ERROR_NOT_ENOUGH_MEMORY
;
1056 if (!RtlCreateUnicodeStringFromAsciiz(&SubKeyString
, lpSubKey
))
1058 ErrorCode
= ERROR_NOT_ENOUGH_MEMORY
;
1063 ErrorCode
= RegCreateKeyExW(
1065 SubKeyString
.Buffer
,
1070 lpSecurityAttributes
,
1075 RtlFreeUnicodeString(&SubKeyString
);
1076 RtlFreeUnicodeString(&ClassString
);
1082 /************************************************************************
1091 _In_ LPCWSTR lpSubKey
,
1092 _In_ DWORD Reserved
,
1093 _In_opt_ LPWSTR lpClass
,
1094 _In_ DWORD dwOptions
,
1095 _In_ REGSAM samDesired
,
1096 _In_opt_ LPSECURITY_ATTRIBUTES lpSecurityAttributes
,
1097 _Out_ PHKEY phkResult
,
1098 _Out_opt_ LPDWORD lpdwDisposition
)
1100 UNICODE_STRING SubKeyString
;
1101 UNICODE_STRING ClassString
;
1102 OBJECT_ATTRIBUTES ObjectAttributes
;
1104 ULONG Attributes
= OBJ_CASE_INSENSITIVE
;
1107 TRACE("RegCreateKeyExW() called\n");
1109 if (lpSecurityAttributes
&& lpSecurityAttributes
->nLength
!= sizeof(SECURITY_ATTRIBUTES
))
1110 return ERROR_INVALID_USER_BUFFER
;
1112 /* get the real parent key */
1113 Status
= MapDefaultKey(&ParentKey
,
1115 if (!NT_SUCCESS(Status
))
1117 return RtlNtStatusToDosError(Status
);
1120 TRACE("ParentKey %p\n", ParentKey
);
1122 if (IsHKCRKey(ParentKey
))
1124 LONG ErrorCode
= CreateHKCRKey(
1131 lpSecurityAttributes
,
1134 ClosePredefKey(ParentKey
);
1138 if (dwOptions
& REG_OPTION_OPEN_LINK
)
1139 Attributes
|= OBJ_OPENLINK
;
1141 RtlInitUnicodeString(&ClassString
,
1143 RtlInitUnicodeString(&SubKeyString
,
1145 InitializeObjectAttributes(&ObjectAttributes
,
1149 lpSecurityAttributes
? (PSECURITY_DESCRIPTOR
)lpSecurityAttributes
->lpSecurityDescriptor
: NULL
);
1150 Status
= CreateNestedKey(phkResult
,
1152 (lpClass
== NULL
)? NULL
: &ClassString
,
1157 ClosePredefKey(ParentKey
);
1159 TRACE("Status %x\n", Status
);
1160 if (!NT_SUCCESS(Status
))
1162 return RtlNtStatusToDosError(Status
);
1165 return ERROR_SUCCESS
;
1169 /************************************************************************
1175 RegCreateKeyA(HKEY hKey
,
1179 return RegCreateKeyExA(hKey
,
1191 /************************************************************************
1197 RegCreateKeyW(HKEY hKey
,
1201 return RegCreateKeyExW(hKey
,
1213 /************************************************************************
1222 _In_ LPCSTR lpSubKey
)
1224 return RegDeleteKeyExA(hKey
, lpSubKey
, 0, 0);
1228 /************************************************************************
1237 _In_ LPCWSTR lpSubKey
)
1239 return RegDeleteKeyExW(hKey
, lpSubKey
, 0, 0);
1243 /************************************************************************
1252 _In_ LPCSTR lpSubKey
,
1253 _In_ REGSAM samDesired
,
1254 _In_ DWORD Reserved
)
1257 UNICODE_STRING SubKeyName
;
1261 if (!RtlCreateUnicodeStringFromAsciiz(&SubKeyName
, lpSubKey
))
1262 return ERROR_NOT_ENOUGH_MEMORY
;
1265 RtlInitEmptyUnicodeString(&SubKeyName
, NULL
, 0);
1267 ErrorCode
= RegDeleteKeyExW(hKey
, SubKeyName
.Buffer
, samDesired
, Reserved
);
1269 RtlFreeUnicodeString(&SubKeyName
);
1275 /************************************************************************
1284 _In_ LPCWSTR lpSubKey
,
1285 _In_ REGSAM samDesired
,
1286 _In_ DWORD Reserved
)
1288 OBJECT_ATTRIBUTES ObjectAttributes
;
1289 UNICODE_STRING SubKeyName
;
1294 /* Make sure we got a subkey */
1298 return ERROR_INVALID_PARAMETER
;
1301 Status
= MapDefaultKey(&ParentKey
,
1303 if (!NT_SUCCESS(Status
))
1305 return RtlNtStatusToDosError(Status
);
1308 if (IsHKCRKey(ParentKey
))
1310 LONG ErrorCode
= DeleteHKCRKey(ParentKey
, lpSubKey
, samDesired
, Reserved
);
1311 ClosePredefKey(ParentKey
);
1315 if (samDesired
& KEY_WOW64_32KEY
)
1316 ERR("Wow64 not yet supported!\n");
1318 if (samDesired
& KEY_WOW64_64KEY
)
1319 ERR("Wow64 not yet supported!\n");
1322 RtlInitUnicodeString(&SubKeyName
,
1324 InitializeObjectAttributes(&ObjectAttributes
,
1326 OBJ_CASE_INSENSITIVE
,
1329 Status
= NtOpenKey(&TargetKey
,
1332 if (!NT_SUCCESS(Status
))
1337 Status
= NtDeleteKey(TargetKey
);
1341 ClosePredefKey(ParentKey
);
1343 if (!NT_SUCCESS(Status
))
1345 return RtlNtStatusToDosError(Status
);
1348 return ERROR_SUCCESS
;
1352 /************************************************************************
1353 * RegDeleteKeyValueW
1358 RegDeleteKeyValueW(IN HKEY hKey
,
1359 IN LPCWSTR lpSubKey OPTIONAL
,
1360 IN LPCWSTR lpValueName OPTIONAL
)
1362 UNICODE_STRING ValueName
;
1363 HANDLE KeyHandle
, CurKey
, SubKeyHandle
= NULL
;
1366 Status
= MapDefaultKey(&KeyHandle
,
1368 if (!NT_SUCCESS(Status
))
1370 return RtlNtStatusToDosError(Status
);
1373 if (lpSubKey
!= NULL
)
1375 OBJECT_ATTRIBUTES ObjectAttributes
;
1376 UNICODE_STRING SubKeyName
;
1378 RtlInitUnicodeString(&SubKeyName
,
1381 InitializeObjectAttributes(&ObjectAttributes
,
1383 OBJ_CASE_INSENSITIVE
,
1387 Status
= NtOpenKey(&SubKeyHandle
,
1390 if (!NT_SUCCESS(Status
))
1395 CurKey
= SubKeyHandle
;
1400 RtlInitUnicodeString(&ValueName
,
1401 (LPWSTR
)lpValueName
);
1403 Status
= NtDeleteValueKey(CurKey
,
1406 if (SubKeyHandle
!= NULL
)
1408 NtClose(SubKeyHandle
);
1412 ClosePredefKey(KeyHandle
);
1414 if (!NT_SUCCESS(Status
))
1416 return RtlNtStatusToDosError(Status
);
1419 return ERROR_SUCCESS
;
1423 /************************************************************************
1424 * RegDeleteKeyValueA
1429 RegDeleteKeyValueA(IN HKEY hKey
,
1430 IN LPCSTR lpSubKey OPTIONAL
,
1431 IN LPCSTR lpValueName OPTIONAL
)
1433 UNICODE_STRING SubKey
= { 0, 0, NULL
}, ValueName
= { 0, 0, NULL
};
1436 if (lpSubKey
!= NULL
&&
1437 !RtlCreateUnicodeStringFromAsciiz(&SubKey
,
1440 return ERROR_NOT_ENOUGH_MEMORY
;
1443 if (lpValueName
!= NULL
&&
1444 !RtlCreateUnicodeStringFromAsciiz(&ValueName
,
1445 (LPSTR
)lpValueName
))
1447 RtlFreeUnicodeString(&SubKey
);
1448 return ERROR_NOT_ENOUGH_MEMORY
;
1451 Ret
= RegDeleteKeyValueW(hKey
,
1455 RtlFreeUnicodeString(&SubKey
);
1456 RtlFreeUnicodeString(&ValueName
);
1462 // Non-recursive RegDeleteTreeW implementation by Thomas, however it needs bugfixing
1464 RegpDeleteTree(IN HKEY hKey
)
1468 LIST_ENTRY ListEntry
;
1470 } REGP_DEL_KEYS
, *PREG_DEL_KEYS
;
1472 LIST_ENTRY delQueueHead
;
1473 PREG_DEL_KEYS delKeys
, newDelKeys
;
1476 PKEY_BASIC_INFORMATION BasicInfo
;
1477 PREG_DEL_KEYS KeyDelRoot
;
1478 NTSTATUS Status
= STATUS_SUCCESS
;
1479 NTSTATUS Status2
= STATUS_SUCCESS
;
1481 InitializeListHead(&delQueueHead
);
1483 ProcessHeap
= RtlGetProcessHeap();
1485 /* NOTE: no need to allocate enough memory for an additional KEY_BASIC_INFORMATION
1486 structure for the root key, we only do that for subkeys as we need to
1487 allocate REGP_DEL_KEYS structures anyway! */
1488 KeyDelRoot
= RtlAllocateHeap(ProcessHeap
,
1490 sizeof(REGP_DEL_KEYS
));
1491 if (KeyDelRoot
!= NULL
)
1493 KeyDelRoot
->KeyHandle
= hKey
;
1494 InsertTailList(&delQueueHead
,
1495 &KeyDelRoot
->ListEntry
);
1499 delKeys
= CONTAINING_RECORD(delQueueHead
.Flink
,
1508 /* check if this key contains subkeys and delete them first by queuing
1509 them at the head of the list */
1510 Status2
= NtEnumerateKey(delKeys
->KeyHandle
,
1512 KeyBasicInformation
,
1517 if (NT_SUCCESS(Status2
))
1519 OBJECT_ATTRIBUTES ObjectAttributes
;
1520 UNICODE_STRING SubKeyName
;
1522 ASSERT(newDelKeys
!= NULL
);
1523 ASSERT(BasicInfo
!= NULL
);
1525 /* don't use RtlInitUnicodeString as the string is not NULL-terminated! */
1526 SubKeyName
.Length
= BasicInfo
->NameLength
;
1527 SubKeyName
.MaximumLength
= BasicInfo
->NameLength
;
1528 SubKeyName
.Buffer
= BasicInfo
->Name
;
1530 InitializeObjectAttributes(&ObjectAttributes
,
1532 OBJ_CASE_INSENSITIVE
,
1536 /* open the subkey */
1537 Status2
= NtOpenKey(&newDelKeys
->KeyHandle
,
1538 DELETE
| KEY_ENUMERATE_SUB_KEYS
,
1540 if (!NT_SUCCESS(Status2
))
1545 /* enqueue this key to the head of the deletion queue */
1546 InsertHeadList(&delQueueHead
,
1547 &newDelKeys
->ListEntry
);
1549 /* try again from the head of the list */
1554 if (Status2
== STATUS_BUFFER_TOO_SMALL
)
1556 newDelKeys
= RtlAllocateHeap(ProcessHeap
,
1558 BufferSize
+ sizeof(REGP_DEL_KEYS
));
1559 if (newDelKeys
!= NULL
)
1561 BasicInfo
= (PKEY_BASIC_INFORMATION
)(newDelKeys
+ 1);
1564 goto ReadFirstSubKey
;
1568 /* don't break, let's try to delete as many keys as possible */
1569 Status2
= STATUS_INSUFFICIENT_RESOURCES
;
1570 goto SubKeyFailureNoFree
;
1573 else if (Status2
== STATUS_BUFFER_OVERFLOW
)
1575 PREG_DEL_KEYS newDelKeys2
;
1577 ASSERT(newDelKeys
!= NULL
);
1579 /* we need more memory to query the key name */
1580 newDelKeys2
= RtlReAllocateHeap(ProcessHeap
,
1583 BufferSize
+ sizeof(REGP_DEL_KEYS
));
1584 if (newDelKeys2
!= NULL
)
1586 newDelKeys
= newDelKeys2
;
1587 BasicInfo
= (PKEY_BASIC_INFORMATION
)(newDelKeys
+ 1);
1590 goto ReadFirstSubKey
;
1594 /* don't break, let's try to delete as many keys as possible */
1595 Status2
= STATUS_INSUFFICIENT_RESOURCES
;
1598 else if (Status2
== STATUS_NO_MORE_ENTRIES
)
1600 /* in some race conditions where another thread would delete
1601 the same tree at the same time, newDelKeys could actually
1603 if (newDelKeys
!= NULL
)
1605 RtlFreeHeap(ProcessHeap
,
1613 /* newDelKeys can be NULL here when NtEnumerateKey returned an
1614 error other than STATUS_BUFFER_TOO_SMALL or STATUS_BUFFER_OVERFLOW! */
1615 if (newDelKeys
!= NULL
)
1617 RtlFreeHeap(ProcessHeap
,
1622 SubKeyFailureNoFree
:
1623 /* don't break, let's try to delete as many keys as possible */
1624 if (NT_SUCCESS(Status
))
1630 Status2
= NtDeleteKey(delKeys
->KeyHandle
);
1632 /* NOTE: do NOT close the handle anymore, it's invalid already! */
1634 if (!NT_SUCCESS(Status2
))
1636 /* close the key handle so we don't leak handles for keys we were
1637 unable to delete. But only do this for handles not supplied
1640 if (delKeys
->KeyHandle
!= hKey
)
1642 NtClose(delKeys
->KeyHandle
);
1645 if (NT_SUCCESS(Status
))
1647 /* don't break, let's try to delete as many keys as possible */
1652 /* remove the entry from the list */
1653 RemoveEntryList(&delKeys
->ListEntry
);
1655 RtlFreeHeap(ProcessHeap
,
1658 } while (!IsListEmpty(&delQueueHead
));
1661 Status
= STATUS_INSUFFICIENT_RESOURCES
;
1667 /************************************************************************
1673 RegDeleteTreeW(IN HKEY hKey
,
1674 IN LPCWSTR lpSubKey OPTIONAL
)
1676 HANDLE KeyHandle
, CurKey
, SubKeyHandle
= NULL
;
1679 Status
= MapDefaultKey(&KeyHandle
,
1681 if (!NT_SUCCESS(Status
))
1683 return RtlNtStatusToDosError(Status
);
1686 if (lpSubKey
!= NULL
)
1688 OBJECT_ATTRIBUTES ObjectAttributes
;
1689 UNICODE_STRING SubKeyName
;
1691 RtlInitUnicodeString(&SubKeyName
,
1694 InitializeObjectAttributes(&ObjectAttributes
,
1696 OBJ_CASE_INSENSITIVE
,
1700 Status
= NtOpenKey(&SubKeyHandle
,
1701 DELETE
| KEY_ENUMERATE_SUB_KEYS
,
1703 if (!NT_SUCCESS(Status
))
1708 CurKey
= SubKeyHandle
;
1713 Status
= RegpDeleteTree(CurKey
);
1715 if (NT_SUCCESS(Status
))
1717 /* make sure we only close hKey (KeyHandle) when the caller specified a
1718 subkey, because the handle would be invalid already! */
1719 if (CurKey
!= KeyHandle
)
1721 ClosePredefKey(KeyHandle
);
1724 return ERROR_SUCCESS
;
1728 /* make sure we close all handles we created! */
1729 if (SubKeyHandle
!= NULL
)
1731 NtClose(SubKeyHandle
);
1735 ClosePredefKey(KeyHandle
);
1737 return RtlNtStatusToDosError(Status
);
1743 /************************************************************************
1750 RegDeleteTreeW(HKEY hKey
,
1754 DWORD dwMaxSubkeyLen
, dwMaxValueLen
;
1755 DWORD dwMaxLen
, dwSize
;
1759 WCHAR szNameBuf
[MAX_PATH
], *lpszName
= szNameBuf
;
1761 TRACE("(hkey=%p,%p %s)\n", hKey
, lpszSubKey
, debugstr_w(lpszSubKey
));
1763 Status
= MapDefaultKey(&KeyHandle
,
1765 if (!NT_SUCCESS(Status
))
1767 return RtlNtStatusToDosError(Status
);
1770 hSubKey
= KeyHandle
;
1774 ret
= RegOpenKeyExW(KeyHandle
, lpszSubKey
, 0, KEY_READ
, &hSubKey
);
1777 ClosePredefKey(KeyHandle
);
1782 /* Get highest length for keys, values */
1783 ret
= RegQueryInfoKeyW(hSubKey
, NULL
, NULL
, NULL
, NULL
,
1784 &dwMaxSubkeyLen
, NULL
, NULL
, &dwMaxValueLen
, NULL
, NULL
, NULL
);
1785 if (ret
) goto cleanup
;
1789 dwMaxLen
= max(dwMaxSubkeyLen
, dwMaxValueLen
);
1790 if (dwMaxLen
> sizeof(szNameBuf
)/sizeof(WCHAR
))
1792 /* Name too big: alloc a buffer for it */
1793 if (!(lpszName
= RtlAllocateHeap( RtlGetProcessHeap(), 0, dwMaxLen
*sizeof(WCHAR
))))
1795 ret
= ERROR_NOT_ENOUGH_MEMORY
;
1801 /* Recursively delete all the subkeys */
1805 if (RegEnumKeyExW(hSubKey
, 0, lpszName
, &dwSize
, NULL
,
1806 NULL
, NULL
, NULL
)) break;
1808 ret
= RegDeleteTreeW(hSubKey
, lpszName
);
1809 if (ret
) goto cleanup
;
1813 ret
= RegDeleteKeyW(KeyHandle
, lpszSubKey
);
1818 if (RegEnumValueW(KeyHandle
, 0, lpszName
, &dwSize
,
1819 NULL
, NULL
, NULL
, NULL
)) break;
1821 ret
= RegDeleteValueW(KeyHandle
, lpszName
);
1822 if (ret
) goto cleanup
;
1826 /* Free buffer if allocated */
1827 if (lpszName
!= szNameBuf
)
1828 RtlFreeHeap( RtlGetProcessHeap(), 0, lpszName
);
1830 RegCloseKey(hSubKey
);
1832 ClosePredefKey(KeyHandle
);
1838 /************************************************************************
1844 RegDeleteTreeA(IN HKEY hKey
,
1845 IN LPCSTR lpSubKey OPTIONAL
)
1847 UNICODE_STRING SubKeyName
= { 0, 0, NULL
};
1850 if (lpSubKey
!= NULL
&&
1851 !RtlCreateUnicodeStringFromAsciiz(&SubKeyName
,
1854 return ERROR_NOT_ENOUGH_MEMORY
;
1857 Ret
= RegDeleteTreeW(hKey
,
1860 RtlFreeUnicodeString(&SubKeyName
);
1866 /************************************************************************
1867 * RegDisableReflectionKey
1872 RegDisableReflectionKey(IN HKEY hBase
)
1874 FIXME("RegDisableReflectionKey(0x%p) UNIMPLEMENTED!\n", hBase
);
1875 return ERROR_CALL_NOT_IMPLEMENTED
;
1879 /************************************************************************
1880 * RegEnableReflectionKey
1885 RegEnableReflectionKey(IN HKEY hBase
)
1887 FIXME("RegEnableReflectionKey(0x%p) UNIMPLEMENTED!\n", hBase
);
1888 return ERROR_CALL_NOT_IMPLEMENTED
;
1892 /******************************************************************************
1893 * RegpApplyRestrictions [internal]
1895 * Helper function for RegGetValueA/W.
1898 RegpApplyRestrictions(DWORD dwFlags
,
1903 /* Check if the type is restricted by the passed flags */
1904 if (*ret
== ERROR_SUCCESS
|| *ret
== ERROR_MORE_DATA
)
1910 case REG_NONE
: dwMask
= RRF_RT_REG_NONE
; break;
1911 case REG_SZ
: dwMask
= RRF_RT_REG_SZ
; break;
1912 case REG_EXPAND_SZ
: dwMask
= RRF_RT_REG_EXPAND_SZ
; break;
1913 case REG_MULTI_SZ
: dwMask
= RRF_RT_REG_MULTI_SZ
; break;
1914 case REG_BINARY
: dwMask
= RRF_RT_REG_BINARY
; break;
1915 case REG_DWORD
: dwMask
= RRF_RT_REG_DWORD
; break;
1916 case REG_QWORD
: dwMask
= RRF_RT_REG_QWORD
; break;
1919 if (dwFlags
& dwMask
)
1921 /* Type is not restricted, check for size mismatch */
1922 if (dwType
== REG_BINARY
)
1926 if ((dwFlags
& RRF_RT_ANY
) == RRF_RT_DWORD
)
1928 else if ((dwFlags
& RRF_RT_ANY
) == RRF_RT_QWORD
)
1931 if (cbExpect
&& cbData
!= cbExpect
)
1932 *ret
= ERROR_DATATYPE_MISMATCH
;
1935 else *ret
= ERROR_UNSUPPORTED_TYPE
;
1940 /******************************************************************************
1941 * RegGetValueW [ADVAPI32.@]
1943 * Retrieves the type and data for a value name associated with a key,
1944 * optionally expanding its content and restricting its type.
1947 * hKey [I] Handle to an open key.
1948 * pszSubKey [I] Name of the subkey of hKey.
1949 * pszValue [I] Name of value under hKey/szSubKey to query.
1950 * dwFlags [I] Flags restricting the value type to retrieve.
1951 * pdwType [O] Destination for the values type, may be NULL.
1952 * pvData [O] Destination for the values content, may be NULL.
1953 * pcbData [I/O] Size of pvData, updated with the size in bytes required to
1954 * retrieve the whole content, including the trailing '\0'
1958 * Success: ERROR_SUCCESS
1959 * Failure: nonzero error code from Winerror.h
1962 * - Unless RRF_NOEXPAND is specified, REG_EXPAND_SZ values are automatically
1963 * expanded and pdwType is set to REG_SZ instead.
1964 * - Restrictions are applied after expanding, using RRF_RT_REG_EXPAND_SZ
1965 * without RRF_NOEXPAND is thus not allowed.
1966 * An exception is the case where RRF_RT_ANY is specified, because then
1967 * RRF_NOEXPAND is allowed.
1970 RegGetValueW(HKEY hKey
,
1978 DWORD dwType
, cbData
= pcbData
? *pcbData
: 0;
1982 TRACE("(%p,%s,%s,%ld,%p,%p,%p=%ld)\n",
1983 hKey
, debugstr_w(pszSubKey
), debugstr_w(pszValue
), dwFlags
, pdwType
,
1984 pvData
, pcbData
, cbData
);
1986 if (pvData
&& !pcbData
)
1987 return ERROR_INVALID_PARAMETER
;
1988 if ((dwFlags
& RRF_RT_REG_EXPAND_SZ
) && !(dwFlags
& RRF_NOEXPAND
) &&
1989 ((dwFlags
& RRF_RT_ANY
) != RRF_RT_ANY
))
1990 return ERROR_INVALID_PARAMETER
;
1992 if (pszSubKey
&& pszSubKey
[0])
1994 ret
= RegOpenKeyExW(hKey
, pszSubKey
, 0, KEY_QUERY_VALUE
, &hKey
);
1995 if (ret
!= ERROR_SUCCESS
) return ret
;
1998 ret
= RegQueryValueExW(hKey
, pszValue
, NULL
, &dwType
, pvData
, &cbData
);
2000 /* If we are going to expand we need to read in the whole the value even
2001 * if the passed buffer was too small as the expanded string might be
2002 * smaller than the unexpanded one and could fit into cbData bytes. */
2003 if ((ret
== ERROR_SUCCESS
|| ret
== ERROR_MORE_DATA
) &&
2004 dwType
== REG_EXPAND_SZ
&& !(dwFlags
& RRF_NOEXPAND
))
2008 HeapFree(GetProcessHeap(), 0, pvBuf
);
2010 pvBuf
= HeapAlloc(GetProcessHeap(), 0, cbData
);
2013 ret
= ERROR_NOT_ENOUGH_MEMORY
;
2017 if (ret
== ERROR_MORE_DATA
|| !pvData
)
2018 ret
= RegQueryValueExW(hKey
, pszValue
, NULL
,
2019 &dwType
, pvBuf
, &cbData
);
2022 /* Even if cbData was large enough we have to copy the
2023 * string since ExpandEnvironmentStrings can't handle
2024 * overlapping buffers. */
2025 CopyMemory(pvBuf
, pvData
, cbData
);
2028 /* Both the type or the value itself could have been modified in
2029 * between so we have to keep retrying until the buffer is large
2030 * enough or we no longer have to expand the value. */
2032 while (dwType
== REG_EXPAND_SZ
&& ret
== ERROR_MORE_DATA
);
2034 if (ret
== ERROR_SUCCESS
)
2036 /* Recheck dwType in case it changed since the first call */
2037 if (dwType
== REG_EXPAND_SZ
)
2039 cbData
= ExpandEnvironmentStringsW(pvBuf
, pvData
,
2040 pcbData
? *pcbData
: 0) * sizeof(WCHAR
);
2042 if (pvData
&& pcbData
&& cbData
> *pcbData
)
2043 ret
= ERROR_MORE_DATA
;
2046 CopyMemory(pvData
, pvBuf
, *pcbData
);
2049 HeapFree(GetProcessHeap(), 0, pvBuf
);
2052 if (pszSubKey
&& pszSubKey
[0])
2055 RegpApplyRestrictions(dwFlags
, dwType
, cbData
, &ret
);
2057 if (pvData
&& ret
!= ERROR_SUCCESS
&& (dwFlags
& RRF_ZEROONFAILURE
))
2058 ZeroMemory(pvData
, *pcbData
);
2070 /******************************************************************************
2071 * RegGetValueA [ADVAPI32.@]
2076 RegGetValueA(HKEY hKey
,
2084 DWORD dwType
, cbData
= pcbData
? *pcbData
: 0;
2088 TRACE("(%p,%s,%s,%ld,%p,%p,%p=%ld)\n",
2089 hKey
, pszSubKey
, pszValue
, dwFlags
, pdwType
, pvData
, pcbData
,
2092 if (pvData
&& !pcbData
)
2093 return ERROR_INVALID_PARAMETER
;
2094 if ((dwFlags
& RRF_RT_REG_EXPAND_SZ
) && !(dwFlags
& RRF_NOEXPAND
) &&
2095 ((dwFlags
& RRF_RT_ANY
) != RRF_RT_ANY
))
2096 return ERROR_INVALID_PARAMETER
;
2098 if (pszSubKey
&& pszSubKey
[0])
2100 ret
= RegOpenKeyExA(hKey
, pszSubKey
, 0, KEY_QUERY_VALUE
, &hKey
);
2101 if (ret
!= ERROR_SUCCESS
) return ret
;
2104 ret
= RegQueryValueExA(hKey
, pszValue
, NULL
, &dwType
, pvData
, &cbData
);
2106 /* If we are going to expand we need to read in the whole the value even
2107 * if the passed buffer was too small as the expanded string might be
2108 * smaller than the unexpanded one and could fit into cbData bytes. */
2109 if ((ret
== ERROR_SUCCESS
|| ret
== ERROR_MORE_DATA
) &&
2110 (dwType
== REG_EXPAND_SZ
&& !(dwFlags
& RRF_NOEXPAND
)))
2113 HeapFree(GetProcessHeap(), 0, pvBuf
);
2115 pvBuf
= HeapAlloc(GetProcessHeap(), 0, cbData
);
2118 ret
= ERROR_NOT_ENOUGH_MEMORY
;
2122 if (ret
== ERROR_MORE_DATA
|| !pvData
)
2123 ret
= RegQueryValueExA(hKey
, pszValue
, NULL
,
2124 &dwType
, pvBuf
, &cbData
);
2127 /* Even if cbData was large enough we have to copy the
2128 * string since ExpandEnvironmentStrings can't handle
2129 * overlapping buffers. */
2130 CopyMemory(pvBuf
, pvData
, cbData
);
2133 /* Both the type or the value itself could have been modified in
2134 * between so we have to keep retrying until the buffer is large
2135 * enough or we no longer have to expand the value. */
2136 } while (dwType
== REG_EXPAND_SZ
&& ret
== ERROR_MORE_DATA
);
2138 if (ret
== ERROR_SUCCESS
)
2140 /* Recheck dwType in case it changed since the first call */
2141 if (dwType
== REG_EXPAND_SZ
)
2143 cbData
= ExpandEnvironmentStringsA(pvBuf
, pvData
,
2144 pcbData
? *pcbData
: 0);
2146 if(pvData
&& pcbData
&& cbData
> *pcbData
)
2147 ret
= ERROR_MORE_DATA
;
2150 CopyMemory(pvData
, pvBuf
, *pcbData
);
2153 HeapFree(GetProcessHeap(), 0, pvBuf
);
2156 if (pszSubKey
&& pszSubKey
[0])
2159 RegpApplyRestrictions(dwFlags
, dwType
, cbData
, &ret
);
2161 if (pvData
&& ret
!= ERROR_SUCCESS
&& (dwFlags
& RRF_ZEROONFAILURE
))
2162 ZeroMemory(pvData
, *pcbData
);
2164 if (pdwType
) *pdwType
= dwType
;
2165 if (pcbData
) *pcbData
= cbData
;
2171 /************************************************************************
2177 RegSetKeyValueW(IN HKEY hKey
,
2178 IN LPCWSTR lpSubKey OPTIONAL
,
2179 IN LPCWSTR lpValueName OPTIONAL
,
2181 IN LPCVOID lpData OPTIONAL
,
2184 HANDLE KeyHandle
, CurKey
, SubKeyHandle
= NULL
;
2188 Status
= MapDefaultKey(&KeyHandle
,
2190 if (!NT_SUCCESS(Status
))
2192 return RtlNtStatusToDosError(Status
);
2195 if (lpSubKey
!= NULL
)
2197 OBJECT_ATTRIBUTES ObjectAttributes
;
2198 UNICODE_STRING SubKeyName
;
2200 RtlInitUnicodeString(&SubKeyName
,
2203 InitializeObjectAttributes(&ObjectAttributes
,
2205 OBJ_CASE_INSENSITIVE
,
2209 Status
= NtOpenKey(&SubKeyHandle
,
2212 if (!NT_SUCCESS(Status
))
2214 Ret
= RtlNtStatusToDosError(Status
);
2218 CurKey
= SubKeyHandle
;
2223 Ret
= RegSetValueExW(CurKey
,
2230 if (SubKeyHandle
!= NULL
)
2232 NtClose(SubKeyHandle
);
2236 ClosePredefKey(KeyHandle
);
2242 /************************************************************************
2248 RegSetKeyValueA(IN HKEY hKey
,
2249 IN LPCSTR lpSubKey OPTIONAL
,
2250 IN LPCSTR lpValueName OPTIONAL
,
2252 IN LPCVOID lpData OPTIONAL
,
2255 HANDLE KeyHandle
, CurKey
, SubKeyHandle
= NULL
;
2259 Status
= MapDefaultKey(&KeyHandle
,
2261 if (!NT_SUCCESS(Status
))
2263 return RtlNtStatusToDosError(Status
);
2266 if (lpSubKey
!= NULL
)
2268 OBJECT_ATTRIBUTES ObjectAttributes
;
2269 UNICODE_STRING SubKeyName
;
2271 if (!RtlCreateUnicodeStringFromAsciiz(&SubKeyName
,
2274 Ret
= ERROR_NOT_ENOUGH_MEMORY
;
2278 InitializeObjectAttributes(&ObjectAttributes
,
2280 OBJ_CASE_INSENSITIVE
,
2284 Status
= NtOpenKey(&SubKeyHandle
,
2288 RtlFreeUnicodeString(&SubKeyName
);
2290 if (!NT_SUCCESS(Status
))
2292 Ret
= RtlNtStatusToDosError(Status
);
2296 CurKey
= SubKeyHandle
;
2301 Ret
= RegSetValueExA(CurKey
,
2308 if (SubKeyHandle
!= NULL
)
2310 NtClose(SubKeyHandle
);
2314 ClosePredefKey(KeyHandle
);
2320 /************************************************************************
2326 RegDeleteValueA(HKEY hKey
,
2329 UNICODE_STRING ValueName
;
2333 Status
= MapDefaultKey(&KeyHandle
,
2335 if (!NT_SUCCESS(Status
))
2337 return RtlNtStatusToDosError(Status
);
2340 RtlCreateUnicodeStringFromAsciiz(&ValueName
,
2341 (LPSTR
)lpValueName
);
2342 Status
= NtDeleteValueKey(KeyHandle
,
2344 RtlFreeUnicodeString (&ValueName
);
2346 ClosePredefKey(KeyHandle
);
2348 if (!NT_SUCCESS(Status
))
2350 return RtlNtStatusToDosError(Status
);
2353 return ERROR_SUCCESS
;
2357 /************************************************************************
2363 RegDeleteValueW(HKEY hKey
,
2364 LPCWSTR lpValueName
)
2366 UNICODE_STRING ValueName
;
2370 Status
= MapDefaultKey(&KeyHandle
,
2372 if (!NT_SUCCESS(Status
))
2374 return RtlNtStatusToDosError(Status
);
2377 RtlInitUnicodeString(&ValueName
,
2378 (LPWSTR
)lpValueName
);
2380 Status
= NtDeleteValueKey(KeyHandle
,
2383 ClosePredefKey(KeyHandle
);
2385 if (!NT_SUCCESS(Status
))
2387 return RtlNtStatusToDosError(Status
);
2390 return ERROR_SUCCESS
;
2394 /************************************************************************
2400 RegEnumKeyA(HKEY hKey
,
2408 return RegEnumKeyExA(hKey
,
2419 /************************************************************************
2425 RegEnumKeyW(HKEY hKey
,
2433 return RegEnumKeyExW(hKey
,
2444 /************************************************************************
2455 _Inout_ LPDWORD lpcbName
,
2456 _Reserved_ LPDWORD lpReserved
,
2457 _Out_opt_ LPSTR lpClass
,
2458 _Inout_opt_ LPDWORD lpcbClass
,
2459 _Out_opt_ PFILETIME lpftLastWriteTime
)
2461 WCHAR
* NameBuffer
= NULL
;
2462 WCHAR
* ClassBuffer
= NULL
;
2463 DWORD NameLength
, ClassLength
;
2466 /* Allocate our buffers */
2469 NameLength
= *lpcbName
;
2470 NameBuffer
= RtlAllocateHeap(RtlGetProcessHeap(), 0, *lpcbName
* sizeof(WCHAR
));
2471 if (NameBuffer
== NULL
)
2473 ErrorCode
= ERROR_NOT_ENOUGH_MEMORY
;
2482 ClassLength
= *lpcbClass
;
2483 ClassBuffer
= RtlAllocateHeap(RtlGetProcessHeap(), 0, *lpcbClass
* sizeof(WCHAR
));
2484 if (ClassBuffer
== NULL
)
2486 ErrorCode
= ERROR_NOT_ENOUGH_MEMORY
;
2492 /* Do the actual call */
2493 ErrorCode
= RegEnumKeyExW(
2503 if (ErrorCode
!= ERROR_SUCCESS
)
2506 /* Convert the strings */
2507 RtlUnicodeToMultiByteN(lpName
, *lpcbName
, 0, NameBuffer
, *lpcbName
* sizeof(WCHAR
));
2508 /* NULL terminate if we can */
2509 if (NameLength
> *lpcbName
)
2510 lpName
[*lpcbName
] = '\0';
2514 RtlUnicodeToMultiByteN(lpClass
, *lpcbClass
, 0, NameBuffer
, *lpcbClass
* sizeof(WCHAR
));
2515 if (ClassLength
> *lpcbClass
)
2516 lpClass
[*lpcbClass
] = '\0';
2521 RtlFreeHeap(RtlGetProcessHeap(), 0, NameBuffer
);
2523 RtlFreeHeap(RtlGetProcessHeap(), 0, ClassBuffer
);
2529 /************************************************************************
2539 _Out_ LPWSTR lpName
,
2540 _Inout_ LPDWORD lpcbName
,
2541 _Reserved_ LPDWORD lpReserved
,
2542 _Out_opt_ LPWSTR lpClass
,
2543 _Inout_opt_ LPDWORD lpcbClass
,
2544 _Out_opt_ PFILETIME lpftLastWriteTime
)
2548 KEY_NODE_INFORMATION Node
;
2549 KEY_BASIC_INFORMATION Basic
;
2555 ULONG ClassLength
= 0;
2557 LONG ErrorCode
= ERROR_SUCCESS
;
2560 Status
= MapDefaultKey(&KeyHandle
,
2562 if (!NT_SUCCESS(Status
))
2564 return RtlNtStatusToDosError(Status
);
2567 if (IsHKCRKey(KeyHandle
))
2569 ErrorCode
= EnumHKCRKey(
2578 ClosePredefKey(KeyHandle
);
2584 NameLength
= min (*lpcbName
- 1, REG_MAX_NAME_SIZE
) * sizeof (WCHAR
);
2595 ClassLength
= min (*lpcbClass
- 1, REG_MAX_NAME_SIZE
) * sizeof(WCHAR
);
2602 BufferSize
= ((sizeof(KEY_NODE_INFORMATION
) + NameLength
+ 3) & ~3) + ClassLength
;
2606 BufferSize
= sizeof(KEY_BASIC_INFORMATION
) + NameLength
;
2609 KeyInfo
= RtlAllocateHeap(ProcessHeap
,
2612 if (KeyInfo
== NULL
)
2614 ErrorCode
= ERROR_OUTOFMEMORY
;
2618 Status
= NtEnumerateKey(KeyHandle
,
2620 lpClass
? KeyNodeInformation
: KeyBasicInformation
,
2624 TRACE("NtEnumerateKey() returned status 0x%X\n", Status
);
2625 if (!NT_SUCCESS(Status
))
2627 ErrorCode
= RtlNtStatusToDosError (Status
);
2631 if (lpClass
== NULL
)
2633 if (KeyInfo
->Basic
.NameLength
> NameLength
)
2635 ErrorCode
= ERROR_BUFFER_OVERFLOW
;
2639 RtlCopyMemory(lpName
,
2640 KeyInfo
->Basic
.Name
,
2641 KeyInfo
->Basic
.NameLength
);
2642 *lpcbName
= (DWORD
)(KeyInfo
->Basic
.NameLength
/ sizeof(WCHAR
));
2643 lpName
[*lpcbName
] = 0;
2648 if (KeyInfo
->Node
.NameLength
> NameLength
||
2649 KeyInfo
->Node
.ClassLength
> ClassLength
)
2651 ErrorCode
= ERROR_BUFFER_OVERFLOW
;
2655 RtlCopyMemory(lpName
,
2657 KeyInfo
->Node
.NameLength
);
2658 *lpcbName
= KeyInfo
->Node
.NameLength
/ sizeof(WCHAR
);
2659 lpName
[*lpcbName
] = 0;
2660 RtlCopyMemory(lpClass
,
2661 (PVOID
)((ULONG_PTR
)KeyInfo
->Node
.Name
+ KeyInfo
->Node
.ClassOffset
),
2662 KeyInfo
->Node
.ClassLength
);
2663 *lpcbClass
= (DWORD
)(KeyInfo
->Node
.ClassLength
/ sizeof(WCHAR
));
2664 lpClass
[*lpcbClass
] = 0;
2668 if (ErrorCode
== ERROR_SUCCESS
&& lpftLastWriteTime
!= NULL
)
2670 if (lpClass
== NULL
)
2672 lpftLastWriteTime
->dwLowDateTime
= KeyInfo
->Basic
.LastWriteTime
.u
.LowPart
;
2673 lpftLastWriteTime
->dwHighDateTime
= KeyInfo
->Basic
.LastWriteTime
.u
.HighPart
;
2677 lpftLastWriteTime
->dwLowDateTime
= KeyInfo
->Node
.LastWriteTime
.u
.LowPart
;
2678 lpftLastWriteTime
->dwHighDateTime
= KeyInfo
->Node
.LastWriteTime
.u
.HighPart
;
2683 RtlFreeHeap(ProcessHeap
,
2688 ClosePredefKey(KeyHandle
);
2694 /************************************************************************
2704 _Inout_ LPDWORD lpcbName
,
2705 _Reserved_ LPDWORD lpdwReserved
,
2706 _Out_opt_ LPDWORD lpdwType
,
2707 _Out_opt_ LPBYTE lpData
,
2708 _Inout_opt_ LPDWORD lpcbData
)
2711 DWORD NameBufferSize
, NameLength
;
2713 DWORD LocalType
= REG_NONE
;
2714 BOOL NameOverflow
= FALSE
;
2716 /* Do parameter checks now, once and for all. */
2717 if (!lpName
|| !lpcbName
)
2718 return ERROR_INVALID_PARAMETER
;
2720 if ((lpData
&& !lpcbData
) || lpdwReserved
)
2721 return ERROR_INVALID_PARAMETER
;
2723 /* Get the size of the buffer we must use for the first call to RegEnumValueW */
2724 ErrorCode
= RegQueryInfoKeyW(
2725 hKey
, NULL
, NULL
, NULL
, NULL
, NULL
, NULL
, NULL
, &NameBufferSize
, NULL
, NULL
, NULL
);
2726 if (ErrorCode
!= ERROR_SUCCESS
)
2729 /* Add space for the null terminator */
2732 /* Allocate the buffer for the unicode name */
2733 NameBuffer
= RtlAllocateHeap(RtlGetProcessHeap(), 0, NameBufferSize
* sizeof(WCHAR
));
2734 if (NameBuffer
== NULL
)
2736 return ERROR_NOT_ENOUGH_MEMORY
;
2740 * This code calls RegEnumValueW twice, because we need to know the type of the enumerated value.
2741 * So for the first call, we check if we overflow on the name, as we have no way of knowing if this
2742 * is an overflow on the data or on the name during the the second call. So the first time, we make the
2743 * call with the supplied value. This is merdique, but this is how it is.
2745 NameLength
= *lpcbName
;
2746 ErrorCode
= RegEnumValueW(
2755 if (ErrorCode
!= ERROR_SUCCESS
)
2757 if (ErrorCode
== ERROR_MORE_DATA
)
2758 NameOverflow
= TRUE
;
2763 if (is_string(LocalType
) && lpcbData
)
2765 /* We must allocate a buffer to get the unicode data */
2766 DWORD DataBufferSize
= *lpcbData
* sizeof(WCHAR
);
2767 WCHAR
* DataBuffer
= NULL
;
2768 DWORD DataLength
= *lpcbData
;
2769 LPSTR DataStr
= (LPSTR
)lpData
;
2772 DataBuffer
= RtlAllocateHeap(RtlGetProcessHeap(), 0, *lpcbData
* sizeof(WCHAR
));
2774 /* Do the real call */
2775 ErrorCode
= RegEnumValueW(
2785 *lpcbData
= DataBufferSize
/ sizeof(WCHAR
);
2787 if (ErrorCode
!= ERROR_SUCCESS
)
2789 RtlFreeHeap(RtlGetProcessHeap(), 0, DataBuffer
);
2793 /* Copy the data whatever the error code is */
2796 /* Do the data conversion */
2797 RtlUnicodeToMultiByteN(DataStr
, DataLength
, 0, DataBuffer
, DataBufferSize
);
2798 /* NULL-terminate if there is enough room */
2799 if ((DataLength
> *lpcbData
) && (DataStr
[*lpcbData
- 1] != '\0'))
2800 DataStr
[*lpcbData
] = '\0';
2803 RtlFreeHeap(RtlGetProcessHeap(), 0, DataBuffer
);
2807 /* No data conversion needed. Do the call with provided buffers */
2808 ErrorCode
= RegEnumValueW(
2818 if (ErrorCode
!= ERROR_SUCCESS
)
2826 ErrorCode
= ERROR_MORE_DATA
;
2830 /* Convert the name string */
2831 RtlUnicodeToMultiByteN(lpName
, *lpcbName
, lpcbName
, NameBuffer
, NameBufferSize
* sizeof(WCHAR
));
2832 ((PSTR
)lpName
)[*lpcbName
] = '\0';
2836 RtlFreeHeap(RtlGetProcessHeap(), 0, NameBuffer
);
2842 /******************************************************************************
2843 * RegEnumValueW [ADVAPI32.@]
2847 * hkey [I] Handle to key to query
2848 * index [I] Index of value to query
2849 * value [O] Value string
2850 * val_count [I/O] Size of value buffer (in wchars)
2851 * reserved [I] Reserved
2852 * type [O] Type code
2853 * data [O] Value data
2854 * count [I/O] Size of data buffer (in bytes)
2857 * Success: ERROR_SUCCESS
2858 * Failure: nonzero error code from Winerror.h
2866 _Inout_ PDWORD val_count
,
2867 _Reserved_ PDWORD reserved
,
2868 _Out_opt_ PDWORD type
,
2869 _Out_opt_ LPBYTE data
,
2870 _Inout_opt_ PDWORD count
)
2875 char buffer
[256], *buf_ptr
= buffer
;
2876 KEY_VALUE_FULL_INFORMATION
*info
= (KEY_VALUE_FULL_INFORMATION
*)buffer
;
2877 static const int info_size
= FIELD_OFFSET( KEY_VALUE_FULL_INFORMATION
, Name
);
2879 TRACE("(%p,%ld,%p,%p,%p,%p,%p,%p)\n",
2880 hKey
, index
, value
, val_count
, reserved
, type
, data
, count
);
2882 if (!value
|| !val_count
)
2883 return ERROR_INVALID_PARAMETER
;
2885 if ((data
&& !count
) || reserved
)
2886 return ERROR_INVALID_PARAMETER
;
2888 status
= MapDefaultKey(&KeyHandle
, hKey
);
2889 if (!NT_SUCCESS(status
))
2891 return RtlNtStatusToDosError(status
);
2894 if (IsHKCRKey(KeyHandle
))
2896 LONG ErrorCode
= EnumHKCRValue(
2905 ClosePredefKey(KeyHandle
);
2909 total_size
= info_size
+ (MAX_PATH
+ 1) * sizeof(WCHAR
);
2910 if (data
) total_size
+= *count
;
2911 total_size
= min( sizeof(buffer
), total_size
);
2913 status
= NtEnumerateValueKey( KeyHandle
, index
, KeyValueFullInformation
,
2914 buffer
, total_size
, &total_size
);
2915 if (status
&& (status
!= STATUS_BUFFER_OVERFLOW
) && (status
!= STATUS_BUFFER_TOO_SMALL
)) goto done
;
2919 /* retry with a dynamically allocated buffer */
2920 while ((status
== STATUS_BUFFER_OVERFLOW
) || (status
== STATUS_BUFFER_TOO_SMALL
))
2922 if (buf_ptr
!= buffer
) HeapFree( GetProcessHeap(), 0, buf_ptr
);
2923 if (!(buf_ptr
= HeapAlloc( GetProcessHeap(), 0, total_size
)))
2925 status
= ERROR_NOT_ENOUGH_MEMORY
;
2928 info
= (KEY_VALUE_FULL_INFORMATION
*)buf_ptr
;
2929 status
= NtEnumerateValueKey( KeyHandle
, index
, KeyValueFullInformation
,
2930 buf_ptr
, total_size
, &total_size
);
2933 if (status
) goto done
;
2937 if (info
->NameLength
/sizeof(WCHAR
) >= *val_count
)
2939 status
= STATUS_BUFFER_OVERFLOW
;
2942 memcpy( value
, info
->Name
, info
->NameLength
);
2943 *val_count
= info
->NameLength
/ sizeof(WCHAR
);
2944 value
[*val_count
] = 0;
2949 if (info
->DataLength
> *count
)
2951 status
= STATUS_BUFFER_OVERFLOW
;
2954 memcpy( data
, buf_ptr
+ info
->DataOffset
, info
->DataLength
);
2955 if (is_string(info
->Type
) && info
->DataLength
<= *count
- sizeof(WCHAR
))
2957 /* if the type is REG_SZ and data is not 0-terminated
2958 * and there is enough space in the buffer NT appends a \0 */
2959 WCHAR
*ptr
= (WCHAR
*)(data
+ info
->DataLength
);
2960 if (ptr
> (WCHAR
*)data
&& ptr
[-1]) *ptr
= 0;
2964 else status
= STATUS_SUCCESS
;
2967 if (type
) *type
= info
->Type
;
2968 if (count
) *count
= info
->DataLength
;
2971 if (buf_ptr
!= buffer
) HeapFree( GetProcessHeap(), 0, buf_ptr
);
2972 ClosePredefKey(KeyHandle
);
2973 return RtlNtStatusToDosError(status
);
2977 /************************************************************************
2983 RegFlushKey(HKEY hKey
)
2988 if (hKey
== HKEY_PERFORMANCE_DATA
)
2990 return ERROR_SUCCESS
;
2993 Status
= MapDefaultKey(&KeyHandle
,
2995 if (!NT_SUCCESS(Status
))
2997 return RtlNtStatusToDosError(Status
);
3000 Status
= NtFlushKey(KeyHandle
);
3002 ClosePredefKey(KeyHandle
);
3004 if (!NT_SUCCESS(Status
))
3006 return RtlNtStatusToDosError(Status
);
3009 return ERROR_SUCCESS
;
3013 /************************************************************************
3019 RegGetKeySecurity(HKEY hKey
,
3020 SECURITY_INFORMATION SecurityInformation
,
3021 PSECURITY_DESCRIPTOR pSecurityDescriptor
,
3022 LPDWORD lpcbSecurityDescriptor
)
3027 if (hKey
== HKEY_PERFORMANCE_DATA
)
3029 return ERROR_INVALID_HANDLE
;
3032 Status
= MapDefaultKey(&KeyHandle
,
3034 if (!NT_SUCCESS(Status
))
3036 TRACE("MapDefaultKey() failed (Status %lx)\n", Status
);
3037 return RtlNtStatusToDosError(Status
);
3040 Status
= NtQuerySecurityObject(KeyHandle
,
3041 SecurityInformation
,
3042 pSecurityDescriptor
,
3043 *lpcbSecurityDescriptor
,
3044 lpcbSecurityDescriptor
);
3046 ClosePredefKey(KeyHandle
);
3048 if (!NT_SUCCESS(Status
))
3050 WARN("NtQuerySecurityObject() failed (Status %lx)\n", Status
);
3051 return RtlNtStatusToDosError(Status
);
3054 return ERROR_SUCCESS
;
3058 /************************************************************************
3064 RegLoadKeyA(HKEY hKey
,
3068 UNICODE_STRING FileName
;
3069 UNICODE_STRING KeyName
;
3072 RtlInitEmptyUnicodeString(&KeyName
, NULL
, 0);
3073 RtlInitEmptyUnicodeString(&FileName
, NULL
, 0);
3077 if (!RtlCreateUnicodeStringFromAsciiz(&KeyName
, lpSubKey
))
3079 ErrorCode
= ERROR_NOT_ENOUGH_MEMORY
;
3086 if (!RtlCreateUnicodeStringFromAsciiz(&FileName
, lpFile
))
3088 ErrorCode
= ERROR_NOT_ENOUGH_MEMORY
;
3093 ErrorCode
= RegLoadKeyW(hKey
,
3098 RtlFreeUnicodeString(&FileName
);
3099 RtlFreeUnicodeString(&KeyName
);
3105 /************************************************************************
3111 RegLoadKeyW(HKEY hKey
,
3115 OBJECT_ATTRIBUTES FileObjectAttributes
;
3116 OBJECT_ATTRIBUTES KeyObjectAttributes
;
3117 UNICODE_STRING FileName
;
3118 UNICODE_STRING KeyName
;
3121 LONG ErrorCode
= ERROR_SUCCESS
;
3123 if (hKey
== HKEY_PERFORMANCE_DATA
)
3125 return ERROR_INVALID_HANDLE
;
3128 Status
= MapDefaultKey(&KeyHandle
,
3130 if (!NT_SUCCESS(Status
))
3132 return RtlNtStatusToDosError(Status
);
3135 if (!RtlDosPathNameToNtPathName_U(lpFile
,
3140 ErrorCode
= ERROR_BAD_PATHNAME
;
3144 InitializeObjectAttributes(&FileObjectAttributes
,
3146 OBJ_CASE_INSENSITIVE
,
3150 RtlInitUnicodeString(&KeyName
,
3153 InitializeObjectAttributes(&KeyObjectAttributes
,
3155 OBJ_CASE_INSENSITIVE
,
3159 Status
= NtLoadKey(&KeyObjectAttributes
,
3160 &FileObjectAttributes
);
3162 RtlFreeHeap(RtlGetProcessHeap(),
3166 if (!NT_SUCCESS(Status
))
3168 ErrorCode
= RtlNtStatusToDosError(Status
);
3173 ClosePredefKey(KeyHandle
);
3179 /************************************************************************
3180 * RegNotifyChangeKeyValue
3185 RegNotifyChangeKeyValue(HKEY hKey
,
3187 DWORD dwNotifyFilter
,
3191 IO_STATUS_BLOCK IoStatusBlock
;
3194 LONG ErrorCode
= ERROR_SUCCESS
;
3196 if (hKey
== HKEY_PERFORMANCE_DATA
)
3198 return ERROR_INVALID_HANDLE
;
3201 if (fAsynchronous
== TRUE
&& hEvent
== NULL
)
3203 return ERROR_INVALID_PARAMETER
;
3206 Status
= MapDefaultKey(&KeyHandle
,
3208 if (!NT_SUCCESS(Status
))
3210 return RtlNtStatusToDosError(Status
);
3213 /* FIXME: Remote key handles must fail */
3215 Status
= NtNotifyChangeKey(KeyHandle
,
3225 if (!NT_SUCCESS(Status
) && Status
!= STATUS_TIMEOUT
)
3227 ErrorCode
= RtlNtStatusToDosError(Status
);
3230 ClosePredefKey(KeyHandle
);
3236 /************************************************************************
3237 * RegOpenCurrentUser
3242 RegOpenCurrentUser(IN REGSAM samDesired
,
3243 OUT PHKEY phkResult
)
3247 Status
= RtlOpenCurrentUser((ACCESS_MASK
)samDesired
,
3248 (PHANDLE
)phkResult
);
3249 if (!NT_SUCCESS(Status
))
3251 /* NOTE - don't set the last error code! just return the error! */
3252 return RtlNtStatusToDosError(Status
);
3255 return ERROR_SUCCESS
;
3259 /************************************************************************
3262 * 20050503 Fireball - imported from WINE
3267 RegOpenKeyA(HKEY hKey
,
3271 TRACE("RegOpenKeyA hKey 0x%x lpSubKey %s phkResult %p\n",
3272 hKey
, lpSubKey
, phkResult
);
3275 return ERROR_INVALID_PARAMETER
;
3277 if (!hKey
&& lpSubKey
&& phkResult
)
3279 return ERROR_INVALID_HANDLE
;
3282 if (!lpSubKey
|| !*lpSubKey
)
3285 return ERROR_SUCCESS
;
3288 return RegOpenKeyExA(hKey
,
3296 /************************************************************************
3301 * 20050503 Fireball - imported from WINE
3306 RegOpenKeyW(HKEY hKey
,
3310 TRACE("RegOpenKeyW hKey 0x%x lpSubKey %S phkResult %p\n",
3311 hKey
, lpSubKey
, phkResult
);
3314 return ERROR_INVALID_PARAMETER
;
3316 if (!hKey
&& lpSubKey
&& phkResult
)
3318 return ERROR_INVALID_HANDLE
;
3321 if (!lpSubKey
|| !*lpSubKey
)
3324 return ERROR_SUCCESS
;
3327 return RegOpenKeyExW(hKey
,
3335 /************************************************************************
3343 _In_ LPCSTR lpSubKey
,
3344 _In_ DWORD ulOptions
,
3345 _In_ REGSAM samDesired
,
3346 _Out_ PHKEY phkResult
)
3348 UNICODE_STRING SubKeyString
;
3351 TRACE("RegOpenKeyExA hKey 0x%x lpSubKey %s ulOptions 0x%x samDesired 0x%x phkResult %p\n",
3352 hKey
, lpSubKey
, ulOptions
, samDesired
, phkResult
);
3356 if (!RtlCreateUnicodeStringFromAsciiz(&SubKeyString
, lpSubKey
))
3357 return ERROR_NOT_ENOUGH_MEMORY
;
3360 RtlInitEmptyUnicodeString(&SubKeyString
, NULL
, 0);
3362 ErrorCode
= RegOpenKeyExW(hKey
, SubKeyString
.Buffer
, ulOptions
, samDesired
, phkResult
);
3364 RtlFreeUnicodeString(&SubKeyString
);
3370 /************************************************************************
3376 RegOpenKeyExW(HKEY hKey
,
3382 OBJECT_ATTRIBUTES ObjectAttributes
;
3383 UNICODE_STRING SubKeyString
;
3386 ULONG Attributes
= OBJ_CASE_INSENSITIVE
;
3387 LONG ErrorCode
= ERROR_SUCCESS
;
3389 TRACE("RegOpenKeyExW hKey 0x%x lpSubKey %S ulOptions 0x%x samDesired 0x%x phkResult %p\n",
3390 hKey
, lpSubKey
, ulOptions
, samDesired
, phkResult
);
3393 return ERROR_INVALID_PARAMETER
;
3396 Status
= MapDefaultKey(&KeyHandle
, hKey
);
3397 if (!NT_SUCCESS(Status
))
3399 return RtlNtStatusToDosError(Status
);
3402 if (IsHKCRKey(KeyHandle
))
3404 ErrorCode
= OpenHKCRKey(KeyHandle
, lpSubKey
, ulOptions
, samDesired
, phkResult
);
3405 ClosePredefKey(KeyHandle
);
3409 if (ulOptions
& REG_OPTION_OPEN_LINK
)
3410 Attributes
|= OBJ_OPENLINK
;
3412 if (lpSubKey
!= NULL
)
3413 RtlInitUnicodeString(&SubKeyString
, (LPWSTR
)lpSubKey
);
3415 RtlInitUnicodeString(&SubKeyString
, (LPWSTR
)L
"");
3417 InitializeObjectAttributes(&ObjectAttributes
,
3423 Status
= NtOpenKey((PHANDLE
)phkResult
,
3427 if (!NT_SUCCESS(Status
))
3429 ErrorCode
= RtlNtStatusToDosError(Status
);
3433 ClosePredefKey(KeyHandle
);
3439 /************************************************************************
3440 * RegOpenUserClassesRoot
3445 RegOpenUserClassesRoot(IN HANDLE hToken
,
3447 IN REGSAM samDesired
,
3448 OUT PHKEY phkResult
)
3450 const WCHAR UserClassesKeyPrefix
[] = L
"\\Registry\\User\\";
3451 const WCHAR UserClassesKeySuffix
[] = L
"_Classes";
3452 PTOKEN_USER TokenUserData
;
3453 ULONG RequiredLength
;
3454 UNICODE_STRING UserSidString
, UserClassesKeyRoot
;
3455 OBJECT_ATTRIBUTES ObjectAttributes
;
3458 /* check parameters */
3459 if (hToken
== NULL
|| dwOptions
!= 0 || phkResult
== NULL
)
3461 return ERROR_INVALID_PARAMETER
;
3465 * Get the user sid from the token
3469 /* determine how much memory we need */
3470 Status
= NtQueryInformationToken(hToken
,
3475 if (!NT_SUCCESS(Status
) && (Status
!= STATUS_BUFFER_TOO_SMALL
))
3477 /* NOTE - as opposed to all other registry functions windows does indeed
3478 change the last error code in case the caller supplied a invalid
3479 handle for example! */
3480 return RtlNtStatusToDosError(Status
);
3482 RegInitialize(); /* HACK until delay-loading is implemented */
3483 TokenUserData
= RtlAllocateHeap(ProcessHeap
,
3486 if (TokenUserData
== NULL
)
3488 return ERROR_NOT_ENOUGH_MEMORY
;
3491 /* attempt to read the information */
3492 Status
= NtQueryInformationToken(hToken
,
3497 if (!NT_SUCCESS(Status
))
3499 RtlFreeHeap(ProcessHeap
,
3502 if (Status
== STATUS_BUFFER_TOO_SMALL
)
3504 /* the information appears to have changed?! try again */
3508 /* NOTE - as opposed to all other registry functions windows does indeed
3509 change the last error code in case the caller supplied a invalid
3510 handle for example! */
3511 return RtlNtStatusToDosError(Status
);
3515 * Build the absolute path for the user's registry in the form
3516 * "\Registry\User\<SID>_Classes"
3518 Status
= RtlConvertSidToUnicodeString(&UserSidString
,
3519 TokenUserData
->User
.Sid
,
3522 /* we don't need the user data anymore, free it */
3523 RtlFreeHeap(ProcessHeap
,
3527 if (!NT_SUCCESS(Status
))
3529 return RtlNtStatusToDosError(Status
);
3532 /* allocate enough memory for the entire key string */
3533 UserClassesKeyRoot
.Length
= 0;
3534 UserClassesKeyRoot
.MaximumLength
= UserSidString
.Length
+
3535 sizeof(UserClassesKeyPrefix
) +
3536 sizeof(UserClassesKeySuffix
);
3537 UserClassesKeyRoot
.Buffer
= RtlAllocateHeap(ProcessHeap
,
3539 UserClassesKeyRoot
.MaximumLength
);
3540 if (UserClassesKeyRoot
.Buffer
== NULL
)
3542 RtlFreeUnicodeString(&UserSidString
);
3543 return RtlNtStatusToDosError(Status
);
3546 /* build the string */
3547 RtlAppendUnicodeToString(&UserClassesKeyRoot
,
3548 UserClassesKeyPrefix
);
3549 RtlAppendUnicodeStringToString(&UserClassesKeyRoot
,
3551 RtlAppendUnicodeToString(&UserClassesKeyRoot
,
3552 UserClassesKeySuffix
);
3554 TRACE("RegOpenUserClassesRoot: Absolute path: %wZ\n", &UserClassesKeyRoot
);
3559 InitializeObjectAttributes(&ObjectAttributes
,
3560 &UserClassesKeyRoot
,
3561 OBJ_CASE_INSENSITIVE
,
3565 Status
= NtOpenKey((PHANDLE
)phkResult
,
3569 RtlFreeUnicodeString(&UserSidString
);
3570 RtlFreeUnicodeString(&UserClassesKeyRoot
);
3572 if (!NT_SUCCESS(Status
))
3574 return RtlNtStatusToDosError(Status
);
3577 return ERROR_SUCCESS
;
3581 /************************************************************************
3587 RegQueryInfoKeyA(HKEY hKey
,
3592 LPDWORD lpcMaxSubKeyLen
,
3593 LPDWORD lpcMaxClassLen
,
3595 LPDWORD lpcMaxValueNameLen
,
3596 LPDWORD lpcMaxValueLen
,
3597 LPDWORD lpcbSecurityDescriptor
,
3598 PFILETIME lpftLastWriteTime
)
3600 WCHAR ClassName
[MAX_PATH
];
3601 UNICODE_STRING UnicodeString
;
3602 ANSI_STRING AnsiString
;
3607 RtlInitUnicodeString(&UnicodeString
,
3609 if (lpClass
!= NULL
)
3611 RtlInitEmptyUnicodeString(&UnicodeString
,
3614 cClass
= sizeof(ClassName
) / sizeof(WCHAR
);
3617 ErrorCode
= RegQueryInfoKeyW(hKey
,
3618 UnicodeString
.Buffer
,
3627 lpcbSecurityDescriptor
,
3629 if ((ErrorCode
== ERROR_SUCCESS
) && (lpClass
!= NULL
))
3636 RtlInitEmptyAnsiString(&AnsiString
, lpClass
, *lpcClass
);
3637 UnicodeString
.Length
= cClass
* sizeof(WCHAR
);
3638 Status
= RtlUnicodeStringToAnsiString(&AnsiString
,
3641 ErrorCode
= RtlNtStatusToDosError(Status
);
3642 cClass
= AnsiString
.Length
;
3643 lpClass
[*lpcClass
- 1] = 0;
3646 if (lpcClass
!= NULL
)
3655 /************************************************************************
3661 RegQueryInfoKeyW(HKEY hKey
,
3666 LPDWORD lpcMaxSubKeyLen
,
3667 LPDWORD lpcMaxClassLen
,
3669 LPDWORD lpcMaxValueNameLen
,
3670 LPDWORD lpcMaxValueLen
,
3671 LPDWORD lpcbSecurityDescriptor
,
3672 PFILETIME lpftLastWriteTime
)
3674 KEY_FULL_INFORMATION FullInfoBuffer
;
3675 PKEY_FULL_INFORMATION FullInfo
;
3677 ULONG ClassLength
= 0;
3681 LONG ErrorCode
= ERROR_SUCCESS
;
3683 if ((lpClass
) && (!lpcClass
))
3685 return ERROR_INVALID_PARAMETER
;
3688 Status
= MapDefaultKey(&KeyHandle
,
3690 if (!NT_SUCCESS(Status
))
3692 return RtlNtStatusToDosError(Status
);
3695 if (lpClass
!= NULL
)
3699 ClassLength
= min(*lpcClass
- 1, REG_MAX_NAME_SIZE
) * sizeof(WCHAR
);
3706 FullInfoSize
= sizeof(KEY_FULL_INFORMATION
) + ((ClassLength
+ 3) & ~3);
3707 FullInfo
= RtlAllocateHeap(ProcessHeap
,
3710 if (FullInfo
== NULL
)
3712 ErrorCode
= ERROR_OUTOFMEMORY
;
3718 FullInfoSize
= sizeof(KEY_FULL_INFORMATION
);
3719 FullInfo
= &FullInfoBuffer
;
3722 Status
= NtQueryKey(KeyHandle
,
3727 TRACE("NtQueryKey() returned status 0x%X\n", Status
);
3728 if (!NT_SUCCESS(Status
) && Status
!= STATUS_BUFFER_OVERFLOW
)
3730 ErrorCode
= RtlNtStatusToDosError(Status
);
3734 TRACE("SubKeys %d\n", FullInfo
->SubKeys
);
3735 if (lpcSubKeys
!= NULL
)
3737 *lpcSubKeys
= FullInfo
->SubKeys
;
3740 TRACE("MaxNameLen %lu\n", FullInfo
->MaxNameLen
);
3741 if (lpcMaxSubKeyLen
!= NULL
)
3743 *lpcMaxSubKeyLen
= FullInfo
->MaxNameLen
/ sizeof(WCHAR
);
3746 TRACE("MaxClassLen %lu\n", FullInfo
->MaxClassLen
);
3747 if (lpcMaxClassLen
!= NULL
)
3749 *lpcMaxClassLen
= FullInfo
->MaxClassLen
/ sizeof(WCHAR
);
3752 TRACE("Values %lu\n", FullInfo
->Values
);
3753 if (lpcValues
!= NULL
)
3755 *lpcValues
= FullInfo
->Values
;
3758 TRACE("MaxValueNameLen %lu\n", FullInfo
->MaxValueNameLen
);
3759 if (lpcMaxValueNameLen
!= NULL
)
3761 *lpcMaxValueNameLen
= FullInfo
->MaxValueNameLen
/ sizeof(WCHAR
);
3764 TRACE("MaxValueDataLen %lu\n", FullInfo
->MaxValueDataLen
);
3765 if (lpcMaxValueLen
!= NULL
)
3767 *lpcMaxValueLen
= FullInfo
->MaxValueDataLen
;
3770 if (lpcbSecurityDescriptor
!= NULL
)
3772 Status
= NtQuerySecurityObject(KeyHandle
,
3773 OWNER_SECURITY_INFORMATION
|
3774 GROUP_SECURITY_INFORMATION
|
3775 DACL_SECURITY_INFORMATION
,
3778 lpcbSecurityDescriptor
);
3779 if (!NT_SUCCESS(Status
) && Status
!= STATUS_BUFFER_TOO_SMALL
)
3781 ErrorCode
= RtlNtStatusToDosError(Status
);
3786 if (lpftLastWriteTime
!= NULL
)
3788 lpftLastWriteTime
->dwLowDateTime
= FullInfo
->LastWriteTime
.u
.LowPart
;
3789 lpftLastWriteTime
->dwHighDateTime
= FullInfo
->LastWriteTime
.u
.HighPart
;
3792 if (lpClass
!= NULL
)
3799 if (FullInfo
->ClassLength
> ClassLength
)
3801 ErrorCode
= ERROR_INSUFFICIENT_BUFFER
;
3805 RtlCopyMemory(lpClass
,
3807 FullInfo
->ClassLength
);
3808 lpClass
[FullInfo
->ClassLength
/ sizeof(WCHAR
)] = UNICODE_NULL
;
3812 if (lpcClass
!= NULL
)
3814 *lpcClass
= FullInfo
->ClassLength
/ sizeof(WCHAR
);
3818 if (lpClass
!= NULL
)
3820 RtlFreeHeap(ProcessHeap
,
3825 ClosePredefKey(KeyHandle
);
3831 /************************************************************************
3832 * RegQueryMultipleValuesA
3837 RegQueryMultipleValuesA(HKEY hKey
,
3844 DWORD maxBytes
= *ldwTotsize
;
3845 LPSTR bufptr
= (LPSTR
)lpValueBuf
;
3848 if (maxBytes
>= (1024*1024))
3849 return ERROR_TRANSFER_TOO_LONG
;
3853 TRACE("RegQueryMultipleValuesA(%p,%p,%ld,%p,%p=%ld)\n",
3854 hKey
, val_list
, num_vals
, lpValueBuf
, ldwTotsize
, *ldwTotsize
);
3856 for (i
= 0; i
< num_vals
; i
++)
3858 val_list
[i
].ve_valuelen
= 0;
3859 ErrorCode
= RegQueryValueExA(hKey
,
3860 val_list
[i
].ve_valuename
,
3864 &val_list
[i
].ve_valuelen
);
3865 if (ErrorCode
!= ERROR_SUCCESS
)
3870 if (lpValueBuf
!= NULL
&& *ldwTotsize
+ val_list
[i
].ve_valuelen
<= maxBytes
)
3872 ErrorCode
= RegQueryValueExA(hKey
,
3873 val_list
[i
].ve_valuename
,
3875 &val_list
[i
].ve_type
,
3877 &val_list
[i
].ve_valuelen
);
3878 if (ErrorCode
!= ERROR_SUCCESS
)
3883 val_list
[i
].ve_valueptr
= (DWORD_PTR
)bufptr
;
3885 bufptr
+= val_list
[i
].ve_valuelen
;
3888 *ldwTotsize
+= val_list
[i
].ve_valuelen
;
3891 return (lpValueBuf
!= NULL
&& *ldwTotsize
<= maxBytes
) ? ERROR_SUCCESS
: ERROR_MORE_DATA
;
3895 /************************************************************************
3896 * RegQueryMultipleValuesW
3901 RegQueryMultipleValuesW(HKEY hKey
,
3908 DWORD maxBytes
= *ldwTotsize
;
3909 LPSTR bufptr
= (LPSTR
)lpValueBuf
;
3912 if (maxBytes
>= (1024*1024))
3913 return ERROR_TRANSFER_TOO_LONG
;
3917 TRACE("RegQueryMultipleValuesW(%p,%p,%ld,%p,%p=%ld)\n",
3918 hKey
, val_list
, num_vals
, lpValueBuf
, ldwTotsize
, *ldwTotsize
);
3920 for (i
= 0; i
< num_vals
; i
++)
3922 val_list
[i
].ve_valuelen
= 0;
3923 ErrorCode
= RegQueryValueExW(hKey
,
3924 val_list
[i
].ve_valuename
,
3928 &val_list
[i
].ve_valuelen
);
3929 if (ErrorCode
!= ERROR_SUCCESS
)
3934 if (lpValueBuf
!= NULL
&& *ldwTotsize
+ val_list
[i
].ve_valuelen
<= maxBytes
)
3936 ErrorCode
= RegQueryValueExW(hKey
,
3937 val_list
[i
].ve_valuename
,
3939 &val_list
[i
].ve_type
,
3941 &val_list
[i
].ve_valuelen
);
3942 if (ErrorCode
!= ERROR_SUCCESS
)
3947 val_list
[i
].ve_valueptr
= (DWORD_PTR
)bufptr
;
3949 bufptr
+= val_list
[i
].ve_valuelen
;
3952 *ldwTotsize
+= val_list
[i
].ve_valuelen
;
3955 return (lpValueBuf
!= NULL
&& *ldwTotsize
<= maxBytes
) ? ERROR_SUCCESS
: ERROR_MORE_DATA
;
3959 /************************************************************************
3960 * RegQueryReflectionKey
3965 RegQueryReflectionKey(IN HKEY hBase
,
3966 OUT BOOL
* bIsReflectionDisabled
)
3968 FIXME("RegQueryReflectionKey(0x%p, 0x%p) UNIMPLEMENTED!\n",
3969 hBase
, bIsReflectionDisabled
);
3970 return ERROR_CALL_NOT_IMPLEMENTED
;
3974 /******************************************************************************
3975 * RegQueryValueExA [ADVAPI32.@]
3977 * Get the type and contents of a specified value under with a key.
3980 * hkey [I] Handle of the key to query
3981 * name [I] Name of value under hkey to query
3982 * reserved [I] Reserved - must be NULL
3983 * type [O] Destination for the value type, or NULL if not required
3984 * data [O] Destination for the values contents, or NULL if not required
3985 * count [I/O] Size of data, updated with the number of bytes returned
3988 * Success: ERROR_SUCCESS. *count is updated with the number of bytes copied to data.
3989 * Failure: ERROR_INVALID_HANDLE, if hkey is invalid.
3990 * ERROR_INVALID_PARAMETER, if any other parameter is invalid.
3991 * ERROR_MORE_DATA, if on input *count is too small to hold the contents.
3994 * MSDN states that if data is too small it is partially filled. In reality
3995 * it remains untouched.
4002 _In_ LPDWORD reserved
,
4003 _Out_opt_ LPDWORD type
,
4004 _Out_opt_ LPBYTE data
,
4005 _Inout_opt_ LPDWORD count
)
4007 UNICODE_STRING nameW
;
4010 DWORD BufferSize
= 0;
4012 CHAR
* DataStr
= (CHAR
*)data
;
4015 /* Validate those parameters, the rest will be done with the first RegQueryValueExW call */
4016 if ((data
&& !count
) || reserved
)
4017 return ERROR_INVALID_PARAMETER
;
4021 if (!RtlCreateUnicodeStringFromAsciiz(&nameW
, name
))
4022 return ERROR_NOT_ENOUGH_MEMORY
;
4025 RtlInitEmptyUnicodeString(&nameW
, NULL
, 0);
4027 ErrorCode
= RegQueryValueExW(hkeyorg
, nameW
.Buffer
, NULL
, &LocalType
, NULL
, &BufferSize
);
4028 if (ErrorCode
!= ERROR_SUCCESS
)
4030 if ((!data
) && count
)
4032 RtlFreeUnicodeString(&nameW
);
4036 /* See if we can directly handle the call without caring for conversion */
4037 if (!is_string(LocalType
) || !count
)
4039 ErrorCode
= RegQueryValueExW(hkeyorg
, nameW
.Buffer
, reserved
, type
, data
, count
);
4040 RtlFreeUnicodeString(&nameW
);
4044 /* Allocate a unicode string to get the data */
4045 Buffer
= RtlAllocateHeap(RtlGetProcessHeap(), 0, BufferSize
);
4048 RtlFreeUnicodeString(&nameW
);
4049 return ERROR_NOT_ENOUGH_MEMORY
;
4052 ErrorCode
= RegQueryValueExW(hkeyorg
, nameW
.Buffer
, reserved
, type
, (LPBYTE
)Buffer
, &BufferSize
);
4053 if (ErrorCode
!= ERROR_SUCCESS
)
4055 RtlFreeHeap(RtlGetProcessHeap(), 0, Buffer
);
4056 RtlFreeUnicodeString(&nameW
);
4060 /* We don't need this anymore */
4061 RtlFreeUnicodeString(&nameW
);
4063 DataLength
= *count
;
4064 RtlUnicodeToMultiByteSize(count
, Buffer
, BufferSize
);
4066 if ((!data
) || (DataLength
< *count
))
4068 RtlFreeHeap(RtlGetProcessHeap(), 0, Buffer
);
4069 return data
? ERROR_MORE_DATA
: ERROR_SUCCESS
;
4072 /* We can finally do the conversion */
4073 RtlUnicodeToMultiByteN(DataStr
, DataLength
, NULL
, Buffer
, BufferSize
);
4075 /* NULL-terminate if there is enough room */
4076 if ((DataLength
> *count
) && (DataStr
[*count
- 1] != '\0'))
4077 DataStr
[*count
] = '\0';
4079 RtlFreeHeap(RtlGetProcessHeap(), 0, Buffer
);
4081 return ERROR_SUCCESS
;
4085 /************************************************************************
4095 _In_ LPDWORD reserved
,
4102 UNICODE_STRING name_str
;
4104 char buffer
[256], *buf_ptr
= buffer
;
4105 KEY_VALUE_PARTIAL_INFORMATION
*info
= (KEY_VALUE_PARTIAL_INFORMATION
*)buffer
;
4106 static const int info_size
= offsetof( KEY_VALUE_PARTIAL_INFORMATION
, Data
);
4108 TRACE("(%p,%s,%p,%p,%p,%p=%d)\n",
4109 hkeyorg
, debugstr_w(name
), reserved
, type
, data
, count
,
4110 (count
&& data
) ? *count
: 0 );
4112 if ((data
&& !count
) || reserved
) return ERROR_INVALID_PARAMETER
;
4114 status
= MapDefaultKey(&hkey
, hkeyorg
);
4115 if (!NT_SUCCESS(status
))
4117 return RtlNtStatusToDosError(status
);
4120 if (IsHKCRKey(hkey
))
4122 LONG ErrorCode
= QueryHKCRValue(hkey
, name
, reserved
, type
, data
, count
);
4123 ClosePredefKey(hkey
);
4127 RtlInitUnicodeString( &name_str
, name
);
4129 if (data
) total_size
= min( sizeof(buffer
), *count
+ info_size
);
4132 total_size
= info_size
;
4133 if (count
) *count
= 0;
4136 /* this matches Win9x behaviour - NT sets *type to a random value */
4137 if (type
) *type
= REG_NONE
;
4139 status
= NtQueryValueKey( hkey
, &name_str
, KeyValuePartialInformation
,
4140 buffer
, total_size
, &total_size
);
4141 if (!NT_SUCCESS(status
) && status
!= STATUS_BUFFER_OVERFLOW
) goto done
;
4145 /* retry with a dynamically allocated buffer */
4146 while (status
== STATUS_BUFFER_OVERFLOW
&& total_size
- info_size
<= *count
)
4148 if (buf_ptr
!= buffer
) HeapFree( GetProcessHeap(), 0, buf_ptr
);
4149 if (!(buf_ptr
= HeapAlloc( GetProcessHeap(), 0, total_size
)))
4151 ClosePredefKey(hkey
);
4152 return ERROR_NOT_ENOUGH_MEMORY
;
4154 info
= (KEY_VALUE_PARTIAL_INFORMATION
*)buf_ptr
;
4155 status
= NtQueryValueKey( hkey
, &name_str
, KeyValuePartialInformation
,
4156 buf_ptr
, total_size
, &total_size
);
4159 if (NT_SUCCESS(status
))
4161 memcpy( data
, buf_ptr
+ info_size
, total_size
- info_size
);
4162 /* if the type is REG_SZ and data is not 0-terminated
4163 * and there is enough space in the buffer NT appends a \0 */
4164 if (is_string(info
->Type
) && total_size
- info_size
<= *count
-sizeof(WCHAR
))
4166 WCHAR
*ptr
= (WCHAR
*)(data
+ total_size
- info_size
);
4167 if (ptr
> (WCHAR
*)data
&& ptr
[-1]) *ptr
= 0;
4170 else if (status
!= STATUS_BUFFER_OVERFLOW
) goto done
;
4172 else status
= STATUS_SUCCESS
;
4174 if (type
) *type
= info
->Type
;
4175 if (count
) *count
= total_size
- info_size
;
4178 if (buf_ptr
!= buffer
) HeapFree( GetProcessHeap(), 0, buf_ptr
);
4179 ClosePredefKey(hkey
);
4180 return RtlNtStatusToDosError(status
);
4184 /************************************************************************
4189 LSTATUS WINAPI
RegQueryValueA( HKEY hkey
, LPCSTR name
, LPSTR data
, LPLONG count
)
4194 TRACE("(%p,%s,%p,%d)\n", hkey
, debugstr_a(name
), data
, count
? *count
: 0 );
4196 if (name
&& name
[0])
4198 if ((ret
= RegOpenKeyA( hkey
, name
, &subkey
)) != ERROR_SUCCESS
) return ret
;
4200 ret
= RegQueryValueExA( subkey
, NULL
, NULL
, NULL
, (LPBYTE
)data
, (LPDWORD
)count
);
4201 if (subkey
!= hkey
) RegCloseKey( subkey
);
4202 if (ret
== ERROR_FILE_NOT_FOUND
)
4204 /* return empty string if default value not found */
4205 if (data
) *data
= 0;
4206 if (count
) *count
= 1;
4207 ret
= ERROR_SUCCESS
;
4213 /************************************************************************
4218 LSTATUS WINAPI
RegQueryValueW( HKEY hkey
, LPCWSTR name
, LPWSTR data
, LPLONG count
)
4223 TRACE("(%p,%s,%p,%d)\n", hkey
, debugstr_w(name
), data
, count
? *count
: 0 );
4226 return ERROR_INVALID_HANDLE
;
4228 if (name
&& name
[0])
4230 ret
= RegOpenKeyW( hkey
, name
, &subkey
);
4231 if (ret
!= ERROR_SUCCESS
)
4237 ret
= RegQueryValueExW( subkey
, NULL
, NULL
, NULL
, (LPBYTE
)data
, (LPDWORD
)count
);
4241 RegCloseKey( subkey
);
4244 if (ret
== ERROR_FILE_NOT_FOUND
)
4246 /* return empty string if default value not found */
4250 *count
= sizeof(WCHAR
);
4251 ret
= ERROR_SUCCESS
;
4257 /************************************************************************
4263 RegReplaceKeyA(HKEY hKey
,
4268 UNICODE_STRING SubKey
;
4269 UNICODE_STRING NewFile
;
4270 UNICODE_STRING OldFile
;
4273 RtlInitEmptyUnicodeString(&SubKey
, NULL
, 0);
4274 RtlInitEmptyUnicodeString(&OldFile
, NULL
, 0);
4275 RtlInitEmptyUnicodeString(&NewFile
, NULL
, 0);
4279 if (!RtlCreateUnicodeStringFromAsciiz(&SubKey
, lpSubKey
))
4281 ErrorCode
= ERROR_NOT_ENOUGH_MEMORY
;
4288 if (!RtlCreateUnicodeStringFromAsciiz(&OldFile
, lpOldFile
))
4290 ErrorCode
= ERROR_NOT_ENOUGH_MEMORY
;
4297 if (!RtlCreateUnicodeStringFromAsciiz(&NewFile
, lpNewFile
))
4299 ErrorCode
= ERROR_NOT_ENOUGH_MEMORY
;
4304 ErrorCode
= RegReplaceKeyW(hKey
,
4310 RtlFreeUnicodeString(&OldFile
);
4311 RtlFreeUnicodeString(&NewFile
);
4312 RtlFreeUnicodeString(&SubKey
);
4318 /************************************************************************
4324 RegReplaceKeyW(HKEY hKey
,
4329 OBJECT_ATTRIBUTES KeyObjectAttributes
;
4330 OBJECT_ATTRIBUTES NewObjectAttributes
;
4331 OBJECT_ATTRIBUTES OldObjectAttributes
;
4332 UNICODE_STRING SubKeyName
;
4333 UNICODE_STRING NewFileName
;
4334 UNICODE_STRING OldFileName
;
4335 BOOLEAN CloseRealKey
;
4336 HANDLE RealKeyHandle
;
4339 LONG ErrorCode
= ERROR_SUCCESS
;
4341 if (hKey
== HKEY_PERFORMANCE_DATA
)
4343 return ERROR_INVALID_HANDLE
;
4346 Status
= MapDefaultKey(&KeyHandle
,
4348 if (!NT_SUCCESS(Status
))
4350 return RtlNtStatusToDosError(Status
);
4353 /* Open the real key */
4354 if (lpSubKey
!= NULL
&& *lpSubKey
!= (WCHAR
)0)
4356 RtlInitUnicodeString(&SubKeyName
,
4358 InitializeObjectAttributes(&KeyObjectAttributes
,
4360 OBJ_CASE_INSENSITIVE
,
4363 Status
= NtOpenKey(&RealKeyHandle
,
4365 &KeyObjectAttributes
);
4366 if (!NT_SUCCESS(Status
))
4368 ErrorCode
= RtlNtStatusToDosError(Status
);
4372 CloseRealKey
= TRUE
;
4376 RealKeyHandle
= KeyHandle
;
4377 CloseRealKey
= FALSE
;
4380 /* Convert new file name */
4381 if (!RtlDosPathNameToNtPathName_U(lpNewFile
,
4388 NtClose(RealKeyHandle
);
4391 ErrorCode
= ERROR_INVALID_PARAMETER
;
4395 InitializeObjectAttributes(&NewObjectAttributes
,
4397 OBJ_CASE_INSENSITIVE
,
4401 /* Convert old file name */
4402 if (!RtlDosPathNameToNtPathName_U(lpOldFile
,
4407 RtlFreeHeap(RtlGetProcessHeap (),
4409 NewFileName
.Buffer
);
4412 NtClose(RealKeyHandle
);
4415 ErrorCode
= ERROR_INVALID_PARAMETER
;
4419 InitializeObjectAttributes(&OldObjectAttributes
,
4421 OBJ_CASE_INSENSITIVE
,
4425 Status
= NtReplaceKey(&NewObjectAttributes
,
4427 &OldObjectAttributes
);
4429 RtlFreeHeap(RtlGetProcessHeap(),
4431 OldFileName
.Buffer
);
4432 RtlFreeHeap(RtlGetProcessHeap(),
4434 NewFileName
.Buffer
);
4438 NtClose(RealKeyHandle
);
4441 if (!NT_SUCCESS(Status
))
4443 return RtlNtStatusToDosError(Status
);
4447 ClosePredefKey(KeyHandle
);
4453 /************************************************************************
4459 RegRestoreKeyA(HKEY hKey
,
4463 UNICODE_STRING FileName
;
4468 if (!RtlCreateUnicodeStringFromAsciiz(&FileName
, lpFile
))
4469 return ERROR_NOT_ENOUGH_MEMORY
;
4472 RtlInitEmptyUnicodeString(&FileName
, NULL
, 0);
4474 ErrorCode
= RegRestoreKeyW(hKey
,
4478 RtlFreeUnicodeString(&FileName
);
4484 /************************************************************************
4490 RegRestoreKeyW(HKEY hKey
,
4494 OBJECT_ATTRIBUTES ObjectAttributes
;
4495 IO_STATUS_BLOCK IoStatusBlock
;
4496 UNICODE_STRING FileName
;
4501 if (hKey
== HKEY_PERFORMANCE_DATA
)
4503 return ERROR_INVALID_HANDLE
;
4506 Status
= MapDefaultKey(&KeyHandle
,
4508 if (!NT_SUCCESS(Status
))
4510 return RtlNtStatusToDosError(Status
);
4513 if (!RtlDosPathNameToNtPathName_U(lpFile
,
4518 Status
= STATUS_INVALID_PARAMETER
;
4522 InitializeObjectAttributes(&ObjectAttributes
,
4524 OBJ_CASE_INSENSITIVE
,
4528 Status
= NtOpenFile(&FileHandle
,
4533 FILE_SYNCHRONOUS_IO_NONALERT
);
4534 RtlFreeHeap(RtlGetProcessHeap(),
4537 if (!NT_SUCCESS(Status
))
4542 Status
= NtRestoreKey(KeyHandle
,
4545 NtClose (FileHandle
);
4548 ClosePredefKey(KeyHandle
);
4550 if (!NT_SUCCESS(Status
))
4552 return RtlNtStatusToDosError(Status
);
4555 return ERROR_SUCCESS
;
4559 /************************************************************************
4565 RegSaveKeyA(HKEY hKey
,
4567 LPSECURITY_ATTRIBUTES lpSecurityAttributes
)
4569 UNICODE_STRING FileName
;
4574 if (!RtlCreateUnicodeStringFromAsciiz(&FileName
, lpFile
))
4575 return ERROR_NOT_ENOUGH_MEMORY
;
4578 RtlInitEmptyUnicodeString(&FileName
, NULL
, 0);
4580 ErrorCode
= RegSaveKeyW(hKey
,
4582 lpSecurityAttributes
);
4583 RtlFreeUnicodeString(&FileName
);
4589 /************************************************************************
4595 RegSaveKeyW(HKEY hKey
,
4597 LPSECURITY_ATTRIBUTES lpSecurityAttributes
)
4599 PSECURITY_DESCRIPTOR SecurityDescriptor
= NULL
;
4600 OBJECT_ATTRIBUTES ObjectAttributes
;
4601 UNICODE_STRING FileName
;
4602 IO_STATUS_BLOCK IoStatusBlock
;
4607 Status
= MapDefaultKey(&KeyHandle
,
4609 if (!NT_SUCCESS(Status
))
4611 return RtlNtStatusToDosError(Status
);
4614 if (!RtlDosPathNameToNtPathName_U(lpFile
,
4619 Status
= STATUS_INVALID_PARAMETER
;
4623 if (lpSecurityAttributes
!= NULL
)
4625 SecurityDescriptor
= lpSecurityAttributes
->lpSecurityDescriptor
;
4628 InitializeObjectAttributes(&ObjectAttributes
,
4630 OBJ_CASE_INSENSITIVE
,
4632 SecurityDescriptor
);
4633 Status
= NtCreateFile(&FileHandle
,
4634 GENERIC_WRITE
| SYNCHRONIZE
,
4638 FILE_ATTRIBUTE_NORMAL
,
4641 FILE_OPEN_FOR_BACKUP_INTENT
| FILE_SYNCHRONOUS_IO_NONALERT
,
4644 RtlFreeHeap(RtlGetProcessHeap(),
4647 if (!NT_SUCCESS(Status
))
4652 Status
= NtSaveKey(KeyHandle
,
4654 NtClose (FileHandle
);
4657 ClosePredefKey(KeyHandle
);
4659 if (!NT_SUCCESS(Status
))
4661 return RtlNtStatusToDosError(Status
);
4664 return ERROR_SUCCESS
;
4668 /************************************************************************
4675 RegSaveKeyExA(HKEY hKey
,
4677 LPSECURITY_ATTRIBUTES lpSecurityAttributes
,
4680 UNICODE_STRING FileName
;
4685 if (!RtlCreateUnicodeStringFromAsciiz(&FileName
, lpFile
))
4686 return ERROR_NOT_ENOUGH_MEMORY
;
4689 RtlInitEmptyUnicodeString(&FileName
, NULL
, 0);
4691 ErrorCode
= RegSaveKeyExW(hKey
,
4693 lpSecurityAttributes
,
4695 RtlFreeUnicodeString(&FileName
);
4701 /************************************************************************
4708 RegSaveKeyExW(HKEY hKey
,
4710 LPSECURITY_ATTRIBUTES lpSecurityAttributes
,
4715 case REG_STANDARD_FORMAT
:
4716 case REG_LATEST_FORMAT
:
4717 case REG_NO_COMPRESSION
:
4720 return ERROR_INVALID_PARAMETER
;
4723 FIXME("RegSaveKeyExW(): Flags ignored!\n");
4725 return RegSaveKeyW(hKey
,
4727 lpSecurityAttributes
);
4731 /************************************************************************
4737 RegSetKeySecurity(HKEY hKey
,
4738 SECURITY_INFORMATION SecurityInformation
,
4739 PSECURITY_DESCRIPTOR pSecurityDescriptor
)
4744 if (hKey
== HKEY_PERFORMANCE_DATA
)
4746 return ERROR_INVALID_HANDLE
;
4749 Status
= MapDefaultKey(&KeyHandle
,
4751 if (!NT_SUCCESS(Status
))
4753 return RtlNtStatusToDosError(Status
);
4756 Status
= NtSetSecurityObject(KeyHandle
,
4757 SecurityInformation
,
4758 pSecurityDescriptor
);
4760 ClosePredefKey(KeyHandle
);
4762 if (!NT_SUCCESS(Status
))
4764 return RtlNtStatusToDosError(Status
);
4767 return ERROR_SUCCESS
;
4771 /************************************************************************
4777 RegSetValueExA(HKEY hKey
,
4784 UNICODE_STRING ValueName
;
4786 ANSI_STRING AnsiString
;
4787 UNICODE_STRING Data
;
4793 /* Convert SubKey name to Unicode */
4794 if (lpValueName
!= NULL
&& lpValueName
[0] != '\0')
4797 bConverted
= RtlCreateUnicodeStringFromAsciiz(&ValueName
,
4800 return ERROR_NOT_ENOUGH_MEMORY
;
4804 ValueName
.Buffer
= NULL
;
4807 pValueName
= (LPWSTR
)ValueName
.Buffer
;
4810 if (is_string(dwType
) && (cbData
!= 0))
4812 /* Convert ANSI string Data to Unicode */
4813 /* If last character NOT zero then increment length */
4814 LONG bNoNulledStr
= ((lpData
[cbData
-1] != '\0') ? 1 : 0);
4815 AnsiString
.Buffer
= (PSTR
)lpData
;
4816 AnsiString
.Length
= cbData
+ bNoNulledStr
;
4817 AnsiString
.MaximumLength
= cbData
+ bNoNulledStr
;
4818 Status
= RtlAnsiStringToUnicodeString(&Data
,
4822 if (!NT_SUCCESS(Status
))
4824 if (pValueName
!= NULL
)
4825 RtlFreeUnicodeString(&ValueName
);
4827 return RtlNtStatusToDosError(Status
);
4829 pData
= (LPBYTE
)Data
.Buffer
;
4830 DataSize
= cbData
* sizeof(WCHAR
);
4835 pData
= (LPBYTE
)lpData
;
4839 ErrorCode
= RegSetValueExW(hKey
,
4846 if (pValueName
!= NULL
)
4847 RtlFreeUnicodeString(&ValueName
);
4849 if (Data
.Buffer
!= NULL
)
4850 RtlFreeUnicodeString(&Data
);
4856 /************************************************************************
4865 _In_ LPCWSTR lpValueName
,
4866 _In_ DWORD Reserved
,
4868 _In_ CONST BYTE
* lpData
,
4871 UNICODE_STRING ValueName
;
4875 Status
= MapDefaultKey(&KeyHandle
,
4877 if (!NT_SUCCESS(Status
))
4879 return RtlNtStatusToDosError(Status
);
4882 if (IsHKCRKey(KeyHandle
))
4884 LONG ErrorCode
= SetHKCRValue(KeyHandle
, lpValueName
, Reserved
, dwType
, lpData
, cbData
);
4885 ClosePredefKey(KeyHandle
);
4889 if (is_string(dwType
) && (cbData
!= 0))
4891 PWSTR pwsData
= (PWSTR
)lpData
;
4895 if((pwsData
[cbData
/ sizeof(WCHAR
) - 1] != L
'\0') &&
4896 (pwsData
[cbData
/ sizeof(WCHAR
)] == L
'\0'))
4898 /* Increment length if last character is not zero and next is zero */
4899 cbData
+= sizeof(WCHAR
);
4902 _SEH2_EXCEPT(EXCEPTION_EXECUTE_HANDLER
)
4904 ClosePredefKey(KeyHandle
);
4905 return ERROR_NOACCESS
;
4910 RtlInitUnicodeString(&ValueName
, lpValueName
);
4912 Status
= NtSetValueKey(KeyHandle
,
4919 ClosePredefKey(KeyHandle
);
4921 if (!NT_SUCCESS(Status
))
4923 return RtlNtStatusToDosError(Status
);
4926 return ERROR_SUCCESS
;
4930 /************************************************************************
4936 RegSetValueA(HKEY hKeyOriginal
,
4947 TRACE("(%p,%s,%d,%s,%d)\n", hKeyOriginal
, debugstr_a(lpSubKey
), dwType
, debugstr_a(lpData
), cbData
);
4949 if (dwType
!= REG_SZ
|| !lpData
) return ERROR_INVALID_PARAMETER
;
4951 Status
= MapDefaultKey(&hKey
, hKeyOriginal
);
4952 if (!NT_SUCCESS(Status
))
4954 return RtlNtStatusToDosError (Status
);
4958 if (lpSubKey
&& lpSubKey
[0]) /* need to create the subkey */
4960 ret
= RegCreateKeyA(hKey
, lpSubKey
, &subkey
);
4961 if (ret
!= ERROR_SUCCESS
)
4965 ret
= RegSetValueExA( subkey
, NULL
, 0, REG_SZ
, (const BYTE
*)lpData
, strlen(lpData
)+1 );
4967 RegCloseKey(subkey
);
4970 ClosePredefKey(hKey
);
4976 /************************************************************************
4982 RegSetValueW(HKEY hKeyOriginal
,
4993 TRACE("(%p,%s,%d,%s,%d)\n", hKeyOriginal
, debugstr_w(lpSubKey
), dwType
, debugstr_w(lpData
), cbData
);
4995 if (dwType
!= REG_SZ
|| !lpData
)
4996 return ERROR_INVALID_PARAMETER
;
4998 Status
= MapDefaultKey(&hKey
,
5000 if (!NT_SUCCESS(Status
))
5002 return RtlNtStatusToDosError(Status
);
5006 if (lpSubKey
&& lpSubKey
[0]) /* need to create the subkey */
5008 ret
= RegCreateKeyW(hKey
, lpSubKey
, &subkey
);
5009 if (ret
!= ERROR_SUCCESS
)
5013 ret
= RegSetValueExW( subkey
, NULL
, 0, REG_SZ
, (const BYTE
*)lpData
,
5014 (wcslen( lpData
) + 1) * sizeof(WCHAR
) );
5016 RegCloseKey(subkey
);
5019 ClosePredefKey(hKey
);
5025 /************************************************************************
5031 RegUnLoadKeyA(HKEY hKey
,
5034 UNICODE_STRING KeyName
;
5039 if (!RtlCreateUnicodeStringFromAsciiz(&KeyName
, lpSubKey
))
5040 return ERROR_NOT_ENOUGH_MEMORY
;
5043 RtlInitEmptyUnicodeString(&KeyName
, NULL
, 0);
5045 ErrorCode
= RegUnLoadKeyW(hKey
,
5048 RtlFreeUnicodeString (&KeyName
);
5054 /************************************************************************
5060 RegUnLoadKeyW(HKEY hKey
,
5063 OBJECT_ATTRIBUTES ObjectAttributes
;
5064 UNICODE_STRING KeyName
;
5068 if (hKey
== HKEY_PERFORMANCE_DATA
)
5070 return ERROR_INVALID_HANDLE
;
5073 Status
= MapDefaultKey(&KeyHandle
, hKey
);
5074 if (!NT_SUCCESS(Status
))
5076 return RtlNtStatusToDosError(Status
);
5079 RtlInitUnicodeString(&KeyName
,
5082 InitializeObjectAttributes(&ObjectAttributes
,
5084 OBJ_CASE_INSENSITIVE
,
5088 Status
= NtUnloadKey(&ObjectAttributes
);
5090 ClosePredefKey(KeyHandle
);
5092 if (!NT_SUCCESS(Status
))
5094 return RtlNtStatusToDosError(Status
);
5097 return ERROR_SUCCESS
;
5101 /******************************************************************************
5102 * load_string [Internal]
5104 * This is basically a copy of user32/resource.c's LoadStringW. Necessary to
5105 * avoid importing user32, which is higher level than advapi32. Helper for
5108 static int load_string(HINSTANCE hModule
, UINT resId
, LPWSTR pwszBuffer
, INT cMaxChars
)
5115 /* Negative values have to be inverted. */
5116 if (HIWORD(resId
) == 0xffff)
5117 resId
= (UINT
)(-((INT
)resId
));
5119 /* Load the resource into memory and get a pointer to it. */
5120 hResource
= FindResourceW(hModule
, MAKEINTRESOURCEW(LOWORD(resId
>> 4) + 1), (LPWSTR
)RT_STRING
);
5121 if (!hResource
) return 0;
5122 hMemory
= LoadResource(hModule
, hResource
);
5123 if (!hMemory
) return 0;
5124 pString
= LockResource(hMemory
);
5126 /* Strings are length-prefixed. Lowest nibble of resId is an index. */
5127 idxString
= resId
& 0xf;
5128 while (idxString
--) pString
+= *pString
+ 1;
5130 /* If no buffer is given, return length of the string. */
5131 if (!pwszBuffer
) return *pString
;
5133 /* Else copy over the string, respecting the buffer size. */
5134 cMaxChars
= (*pString
< cMaxChars
) ? *pString
: (cMaxChars
- 1);
5137 memcpy(pwszBuffer
, pString
+1, cMaxChars
* sizeof(WCHAR
));
5138 pwszBuffer
[cMaxChars
] = L
'\0';
5145 /************************************************************************
5151 RegLoadMUIStringW(IN HKEY hKey
,
5152 IN LPCWSTR pszValue OPTIONAL
,
5153 OUT LPWSTR pszOutBuf
,
5155 OUT LPDWORD pcbData OPTIONAL
,
5157 IN LPCWSTR pszDirectory OPTIONAL
)
5159 DWORD dwValueType
, cbData
;
5160 LPWSTR pwszTempBuffer
= NULL
, pwszExpandedBuffer
= NULL
;
5163 /* Parameter sanity checks. */
5164 if (!hKey
|| !pszOutBuf
)
5165 return ERROR_INVALID_PARAMETER
;
5167 if (pszDirectory
&& *pszDirectory
)
5169 FIXME("BaseDir parameter not yet supported!\n");
5170 return ERROR_INVALID_PARAMETER
;
5173 /* Check for value existence and correctness of it's type, allocate a buffer and load it. */
5174 result
= RegQueryValueExW(hKey
, pszValue
, NULL
, &dwValueType
, NULL
, &cbData
);
5175 if (result
!= ERROR_SUCCESS
) goto cleanup
;
5176 if (!(dwValueType
== REG_SZ
|| dwValueType
== REG_EXPAND_SZ
) || !cbData
)
5178 result
= ERROR_FILE_NOT_FOUND
;
5181 pwszTempBuffer
= HeapAlloc(GetProcessHeap(), 0, cbData
);
5182 if (!pwszTempBuffer
)
5184 result
= ERROR_NOT_ENOUGH_MEMORY
;
5187 result
= RegQueryValueExW(hKey
, pszValue
, NULL
, &dwValueType
, (LPBYTE
)pwszTempBuffer
, &cbData
);
5188 if (result
!= ERROR_SUCCESS
) goto cleanup
;
5190 /* Expand environment variables, if appropriate, or copy the original string over. */
5191 if (dwValueType
== REG_EXPAND_SZ
)
5193 cbData
= ExpandEnvironmentStringsW(pwszTempBuffer
, NULL
, 0) * sizeof(WCHAR
);
5194 if (!cbData
) goto cleanup
;
5195 pwszExpandedBuffer
= HeapAlloc(GetProcessHeap(), 0, cbData
);
5196 if (!pwszExpandedBuffer
)
5198 result
= ERROR_NOT_ENOUGH_MEMORY
;
5201 ExpandEnvironmentStringsW(pwszTempBuffer
, pwszExpandedBuffer
, cbData
);
5205 pwszExpandedBuffer
= HeapAlloc(GetProcessHeap(), 0, cbData
);
5206 memcpy(pwszExpandedBuffer
, pwszTempBuffer
, cbData
);
5209 /* If the value references a resource based string, parse the value and load the string.
5210 * Else just copy over the original value. */
5211 result
= ERROR_SUCCESS
;
5212 if (*pwszExpandedBuffer
!= L
'@') /* '@' is the prefix for resource based string entries. */
5214 lstrcpynW(pszOutBuf
, pwszExpandedBuffer
, cbOutBuf
/ sizeof(WCHAR
));
5218 WCHAR
*pComma
= wcsrchr(pwszExpandedBuffer
, L
',');
5222 /* Format of the expanded value is 'path_to_dll,-resId' */
5223 if (!pComma
|| pComma
[1] != L
'-')
5225 result
= ERROR_BADKEY
;
5229 uiStringId
= _wtoi(pComma
+2);
5232 hModule
= LoadLibraryExW(pwszExpandedBuffer
+ 1, NULL
, LOAD_LIBRARY_AS_DATAFILE
);
5233 if (!hModule
|| !load_string(hModule
, uiStringId
, pszOutBuf
, cbOutBuf
/ sizeof(WCHAR
)))
5234 result
= ERROR_BADKEY
;
5235 FreeLibrary(hModule
);
5239 HeapFree(GetProcessHeap(), 0, pwszTempBuffer
);
5240 HeapFree(GetProcessHeap(), 0, pwszExpandedBuffer
);
5245 /************************************************************************
5251 RegLoadMUIStringA(IN HKEY hKey
,
5252 IN LPCSTR pszValue OPTIONAL
,
5253 OUT LPSTR pszOutBuf
,
5255 OUT LPDWORD pcbData OPTIONAL
,
5257 IN LPCSTR pszDirectory OPTIONAL
)
5259 UNICODE_STRING valueW
, baseDirW
;
5261 DWORD cbData
= cbOutBuf
* sizeof(WCHAR
);
5264 valueW
.Buffer
= baseDirW
.Buffer
= pwszBuffer
= NULL
;
5265 if (!RtlCreateUnicodeStringFromAsciiz(&valueW
, pszValue
) ||
5266 !RtlCreateUnicodeStringFromAsciiz(&baseDirW
, pszDirectory
) ||
5267 !(pwszBuffer
= HeapAlloc(GetProcessHeap(), 0, cbData
)))
5269 result
= ERROR_NOT_ENOUGH_MEMORY
;
5273 result
= RegLoadMUIStringW(hKey
, valueW
.Buffer
, pwszBuffer
, cbData
, NULL
, Flags
,
5276 if (result
== ERROR_SUCCESS
)
5278 cbData
= WideCharToMultiByte(CP_ACP
, 0, pwszBuffer
, -1, pszOutBuf
, cbOutBuf
, NULL
, NULL
);
5284 HeapFree(GetProcessHeap(), 0, pwszBuffer
);
5285 RtlFreeUnicodeString(&baseDirW
);
5286 RtlFreeUnicodeString(&valueW
);