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 if ((lpClass
) && (!lpcClass
))
3609 return ERROR_INVALID_PARAMETER
;
3612 RtlInitUnicodeString(&UnicodeString
,
3614 if (lpClass
!= NULL
)
3616 RtlInitEmptyUnicodeString(&UnicodeString
,
3619 cClass
= sizeof(ClassName
) / sizeof(WCHAR
);
3622 ErrorCode
= RegQueryInfoKeyW(hKey
,
3623 UnicodeString
.Buffer
,
3632 lpcbSecurityDescriptor
,
3634 if ((ErrorCode
== ERROR_SUCCESS
) && (lpClass
!= NULL
))
3641 RtlInitEmptyAnsiString(&AnsiString
, lpClass
, *lpcClass
);
3642 UnicodeString
.Length
= cClass
* sizeof(WCHAR
);
3643 Status
= RtlUnicodeStringToAnsiString(&AnsiString
,
3646 ErrorCode
= RtlNtStatusToDosError(Status
);
3647 cClass
= AnsiString
.Length
;
3648 lpClass
[cClass
] = ANSI_NULL
;
3651 if (lpcClass
!= NULL
)
3660 /************************************************************************
3666 RegQueryInfoKeyW(HKEY hKey
,
3671 LPDWORD lpcMaxSubKeyLen
,
3672 LPDWORD lpcMaxClassLen
,
3674 LPDWORD lpcMaxValueNameLen
,
3675 LPDWORD lpcMaxValueLen
,
3676 LPDWORD lpcbSecurityDescriptor
,
3677 PFILETIME lpftLastWriteTime
)
3679 KEY_FULL_INFORMATION FullInfoBuffer
;
3680 PKEY_FULL_INFORMATION FullInfo
;
3682 ULONG ClassLength
= 0;
3686 LONG ErrorCode
= ERROR_SUCCESS
;
3688 if ((lpClass
) && (!lpcClass
))
3690 return ERROR_INVALID_PARAMETER
;
3693 Status
= MapDefaultKey(&KeyHandle
,
3695 if (!NT_SUCCESS(Status
))
3697 return RtlNtStatusToDosError(Status
);
3700 if (lpClass
!= NULL
)
3704 ClassLength
= min(*lpcClass
- 1, REG_MAX_NAME_SIZE
) * sizeof(WCHAR
);
3711 FullInfoSize
= sizeof(KEY_FULL_INFORMATION
) + ((ClassLength
+ 3) & ~3);
3712 FullInfo
= RtlAllocateHeap(ProcessHeap
,
3715 if (FullInfo
== NULL
)
3717 ErrorCode
= ERROR_OUTOFMEMORY
;
3723 FullInfoSize
= sizeof(KEY_FULL_INFORMATION
);
3724 FullInfo
= &FullInfoBuffer
;
3727 Status
= NtQueryKey(KeyHandle
,
3732 TRACE("NtQueryKey() returned status 0x%X\n", Status
);
3733 if (!NT_SUCCESS(Status
) && Status
!= STATUS_BUFFER_OVERFLOW
)
3735 ErrorCode
= RtlNtStatusToDosError(Status
);
3739 TRACE("SubKeys %d\n", FullInfo
->SubKeys
);
3740 if (lpcSubKeys
!= NULL
)
3742 *lpcSubKeys
= FullInfo
->SubKeys
;
3745 TRACE("MaxNameLen %lu\n", FullInfo
->MaxNameLen
);
3746 if (lpcMaxSubKeyLen
!= NULL
)
3748 *lpcMaxSubKeyLen
= FullInfo
->MaxNameLen
/ sizeof(WCHAR
);
3751 TRACE("MaxClassLen %lu\n", FullInfo
->MaxClassLen
);
3752 if (lpcMaxClassLen
!= NULL
)
3754 *lpcMaxClassLen
= FullInfo
->MaxClassLen
/ sizeof(WCHAR
);
3757 TRACE("Values %lu\n", FullInfo
->Values
);
3758 if (lpcValues
!= NULL
)
3760 *lpcValues
= FullInfo
->Values
;
3763 TRACE("MaxValueNameLen %lu\n", FullInfo
->MaxValueNameLen
);
3764 if (lpcMaxValueNameLen
!= NULL
)
3766 *lpcMaxValueNameLen
= FullInfo
->MaxValueNameLen
/ sizeof(WCHAR
);
3769 TRACE("MaxValueDataLen %lu\n", FullInfo
->MaxValueDataLen
);
3770 if (lpcMaxValueLen
!= NULL
)
3772 *lpcMaxValueLen
= FullInfo
->MaxValueDataLen
;
3775 if (lpcbSecurityDescriptor
!= NULL
)
3777 Status
= NtQuerySecurityObject(KeyHandle
,
3778 OWNER_SECURITY_INFORMATION
|
3779 GROUP_SECURITY_INFORMATION
|
3780 DACL_SECURITY_INFORMATION
,
3783 lpcbSecurityDescriptor
);
3784 if (Status
!= STATUS_BUFFER_TOO_SMALL
)
3786 *lpcbSecurityDescriptor
= 0;
3790 if (lpftLastWriteTime
!= NULL
)
3792 lpftLastWriteTime
->dwLowDateTime
= FullInfo
->LastWriteTime
.u
.LowPart
;
3793 lpftLastWriteTime
->dwHighDateTime
= FullInfo
->LastWriteTime
.u
.HighPart
;
3796 if (lpClass
!= NULL
)
3803 if (FullInfo
->ClassLength
> ClassLength
)
3805 ErrorCode
= ERROR_INSUFFICIENT_BUFFER
;
3809 RtlCopyMemory(lpClass
,
3811 FullInfo
->ClassLength
);
3812 lpClass
[FullInfo
->ClassLength
/ sizeof(WCHAR
)] = UNICODE_NULL
;
3816 if (lpcClass
!= NULL
)
3818 *lpcClass
= FullInfo
->ClassLength
/ sizeof(WCHAR
);
3822 if (lpClass
!= NULL
)
3824 RtlFreeHeap(ProcessHeap
,
3829 ClosePredefKey(KeyHandle
);
3835 /************************************************************************
3836 * RegQueryMultipleValuesA
3841 RegQueryMultipleValuesA(HKEY hKey
,
3848 DWORD maxBytes
= *ldwTotsize
;
3849 LPSTR bufptr
= (LPSTR
)lpValueBuf
;
3852 if (maxBytes
>= (1024*1024))
3853 return ERROR_TRANSFER_TOO_LONG
;
3857 TRACE("RegQueryMultipleValuesA(%p,%p,%ld,%p,%p=%ld)\n",
3858 hKey
, val_list
, num_vals
, lpValueBuf
, ldwTotsize
, *ldwTotsize
);
3860 for (i
= 0; i
< num_vals
; i
++)
3862 val_list
[i
].ve_valuelen
= 0;
3863 ErrorCode
= RegQueryValueExA(hKey
,
3864 val_list
[i
].ve_valuename
,
3868 &val_list
[i
].ve_valuelen
);
3869 if (ErrorCode
!= ERROR_SUCCESS
)
3874 if (lpValueBuf
!= NULL
&& *ldwTotsize
+ val_list
[i
].ve_valuelen
<= maxBytes
)
3876 ErrorCode
= RegQueryValueExA(hKey
,
3877 val_list
[i
].ve_valuename
,
3879 &val_list
[i
].ve_type
,
3881 &val_list
[i
].ve_valuelen
);
3882 if (ErrorCode
!= ERROR_SUCCESS
)
3887 val_list
[i
].ve_valueptr
= (DWORD_PTR
)bufptr
;
3889 bufptr
+= val_list
[i
].ve_valuelen
;
3892 *ldwTotsize
+= val_list
[i
].ve_valuelen
;
3895 return (lpValueBuf
!= NULL
&& *ldwTotsize
<= maxBytes
) ? ERROR_SUCCESS
: ERROR_MORE_DATA
;
3899 /************************************************************************
3900 * RegQueryMultipleValuesW
3905 RegQueryMultipleValuesW(HKEY hKey
,
3912 DWORD maxBytes
= *ldwTotsize
;
3913 LPSTR bufptr
= (LPSTR
)lpValueBuf
;
3916 if (maxBytes
>= (1024*1024))
3917 return ERROR_TRANSFER_TOO_LONG
;
3921 TRACE("RegQueryMultipleValuesW(%p,%p,%ld,%p,%p=%ld)\n",
3922 hKey
, val_list
, num_vals
, lpValueBuf
, ldwTotsize
, *ldwTotsize
);
3924 for (i
= 0; i
< num_vals
; i
++)
3926 val_list
[i
].ve_valuelen
= 0;
3927 ErrorCode
= RegQueryValueExW(hKey
,
3928 val_list
[i
].ve_valuename
,
3932 &val_list
[i
].ve_valuelen
);
3933 if (ErrorCode
!= ERROR_SUCCESS
)
3938 if (lpValueBuf
!= NULL
&& *ldwTotsize
+ val_list
[i
].ve_valuelen
<= maxBytes
)
3940 ErrorCode
= RegQueryValueExW(hKey
,
3941 val_list
[i
].ve_valuename
,
3943 &val_list
[i
].ve_type
,
3945 &val_list
[i
].ve_valuelen
);
3946 if (ErrorCode
!= ERROR_SUCCESS
)
3951 val_list
[i
].ve_valueptr
= (DWORD_PTR
)bufptr
;
3953 bufptr
+= val_list
[i
].ve_valuelen
;
3956 *ldwTotsize
+= val_list
[i
].ve_valuelen
;
3959 return (lpValueBuf
!= NULL
&& *ldwTotsize
<= maxBytes
) ? ERROR_SUCCESS
: ERROR_MORE_DATA
;
3963 /************************************************************************
3964 * RegQueryReflectionKey
3969 RegQueryReflectionKey(IN HKEY hBase
,
3970 OUT BOOL
* bIsReflectionDisabled
)
3972 FIXME("RegQueryReflectionKey(0x%p, 0x%p) UNIMPLEMENTED!\n",
3973 hBase
, bIsReflectionDisabled
);
3974 return ERROR_CALL_NOT_IMPLEMENTED
;
3978 /******************************************************************************
3979 * RegQueryValueExA [ADVAPI32.@]
3981 * Get the type and contents of a specified value under with a key.
3984 * hkey [I] Handle of the key to query
3985 * name [I] Name of value under hkey to query
3986 * reserved [I] Reserved - must be NULL
3987 * type [O] Destination for the value type, or NULL if not required
3988 * data [O] Destination for the values contents, or NULL if not required
3989 * count [I/O] Size of data, updated with the number of bytes returned
3992 * Success: ERROR_SUCCESS. *count is updated with the number of bytes copied to data.
3993 * Failure: ERROR_INVALID_HANDLE, if hkey is invalid.
3994 * ERROR_INVALID_PARAMETER, if any other parameter is invalid.
3995 * ERROR_MORE_DATA, if on input *count is too small to hold the contents.
3998 * MSDN states that if data is too small it is partially filled. In reality
3999 * it remains untouched.
4006 _In_ LPDWORD reserved
,
4007 _Out_opt_ LPDWORD type
,
4008 _Out_opt_ LPBYTE data
,
4009 _Inout_opt_ LPDWORD count
)
4011 UNICODE_STRING nameW
;
4014 DWORD BufferSize
= 0;
4016 CHAR
* DataStr
= (CHAR
*)data
;
4019 /* Validate those parameters, the rest will be done with the first RegQueryValueExW call */
4020 if ((data
&& !count
) || reserved
)
4021 return ERROR_INVALID_PARAMETER
;
4025 if (!RtlCreateUnicodeStringFromAsciiz(&nameW
, name
))
4026 return ERROR_NOT_ENOUGH_MEMORY
;
4029 RtlInitEmptyUnicodeString(&nameW
, NULL
, 0);
4031 ErrorCode
= RegQueryValueExW(hkeyorg
, nameW
.Buffer
, NULL
, &LocalType
, NULL
, &BufferSize
);
4032 if (ErrorCode
!= ERROR_SUCCESS
)
4034 if ((!data
) && count
)
4036 RtlFreeUnicodeString(&nameW
);
4040 /* See if we can directly handle the call without caring for conversion */
4041 if (!is_string(LocalType
) || !count
)
4043 ErrorCode
= RegQueryValueExW(hkeyorg
, nameW
.Buffer
, reserved
, type
, data
, count
);
4044 RtlFreeUnicodeString(&nameW
);
4048 /* Allocate a unicode string to get the data */
4049 Buffer
= RtlAllocateHeap(RtlGetProcessHeap(), 0, BufferSize
);
4052 RtlFreeUnicodeString(&nameW
);
4053 return ERROR_NOT_ENOUGH_MEMORY
;
4056 ErrorCode
= RegQueryValueExW(hkeyorg
, nameW
.Buffer
, reserved
, type
, (LPBYTE
)Buffer
, &BufferSize
);
4057 if (ErrorCode
!= ERROR_SUCCESS
)
4059 RtlFreeHeap(RtlGetProcessHeap(), 0, Buffer
);
4060 RtlFreeUnicodeString(&nameW
);
4064 /* We don't need this anymore */
4065 RtlFreeUnicodeString(&nameW
);
4067 DataLength
= *count
;
4068 RtlUnicodeToMultiByteSize(count
, Buffer
, BufferSize
);
4070 if ((!data
) || (DataLength
< *count
))
4072 RtlFreeHeap(RtlGetProcessHeap(), 0, Buffer
);
4073 return data
? ERROR_MORE_DATA
: ERROR_SUCCESS
;
4076 /* We can finally do the conversion */
4077 RtlUnicodeToMultiByteN(DataStr
, DataLength
, NULL
, Buffer
, BufferSize
);
4079 /* NULL-terminate if there is enough room */
4080 if ((DataLength
> *count
) && (DataStr
[*count
- 1] != '\0'))
4081 DataStr
[*count
] = '\0';
4083 RtlFreeHeap(RtlGetProcessHeap(), 0, Buffer
);
4085 return ERROR_SUCCESS
;
4089 /************************************************************************
4099 _In_ LPDWORD reserved
,
4106 UNICODE_STRING name_str
;
4108 char buffer
[256], *buf_ptr
= buffer
;
4109 KEY_VALUE_PARTIAL_INFORMATION
*info
= (KEY_VALUE_PARTIAL_INFORMATION
*)buffer
;
4110 static const int info_size
= offsetof( KEY_VALUE_PARTIAL_INFORMATION
, Data
);
4112 TRACE("(%p,%s,%p,%p,%p,%p=%d)\n",
4113 hkeyorg
, debugstr_w(name
), reserved
, type
, data
, count
,
4114 (count
&& data
) ? *count
: 0 );
4116 if ((data
&& !count
) || reserved
) return ERROR_INVALID_PARAMETER
;
4118 status
= MapDefaultKey(&hkey
, hkeyorg
);
4119 if (!NT_SUCCESS(status
))
4121 return RtlNtStatusToDosError(status
);
4124 if (IsHKCRKey(hkey
))
4126 LONG ErrorCode
= QueryHKCRValue(hkey
, name
, reserved
, type
, data
, count
);
4127 ClosePredefKey(hkey
);
4131 RtlInitUnicodeString( &name_str
, name
);
4133 if (data
) total_size
= min( sizeof(buffer
), *count
+ info_size
);
4136 total_size
= info_size
;
4137 if (count
) *count
= 0;
4140 /* this matches Win9x behaviour - NT sets *type to a random value */
4141 if (type
) *type
= REG_NONE
;
4143 status
= NtQueryValueKey( hkey
, &name_str
, KeyValuePartialInformation
,
4144 buffer
, total_size
, &total_size
);
4145 if (!NT_SUCCESS(status
) && status
!= STATUS_BUFFER_OVERFLOW
) goto done
;
4149 /* retry with a dynamically allocated buffer */
4150 while (status
== STATUS_BUFFER_OVERFLOW
&& total_size
- info_size
<= *count
)
4152 if (buf_ptr
!= buffer
) HeapFree( GetProcessHeap(), 0, buf_ptr
);
4153 if (!(buf_ptr
= HeapAlloc( GetProcessHeap(), 0, total_size
)))
4155 ClosePredefKey(hkey
);
4156 return ERROR_NOT_ENOUGH_MEMORY
;
4158 info
= (KEY_VALUE_PARTIAL_INFORMATION
*)buf_ptr
;
4159 status
= NtQueryValueKey( hkey
, &name_str
, KeyValuePartialInformation
,
4160 buf_ptr
, total_size
, &total_size
);
4163 if (NT_SUCCESS(status
))
4165 memcpy( data
, buf_ptr
+ info_size
, total_size
- info_size
);
4166 /* if the type is REG_SZ and data is not 0-terminated
4167 * and there is enough space in the buffer NT appends a \0 */
4168 if (is_string(info
->Type
) && total_size
- info_size
<= *count
-sizeof(WCHAR
))
4170 WCHAR
*ptr
= (WCHAR
*)(data
+ total_size
- info_size
);
4171 if (ptr
> (WCHAR
*)data
&& ptr
[-1]) *ptr
= 0;
4174 else if (status
!= STATUS_BUFFER_OVERFLOW
) goto done
;
4176 else status
= STATUS_SUCCESS
;
4178 if (type
) *type
= info
->Type
;
4179 if (count
) *count
= total_size
- info_size
;
4182 if (buf_ptr
!= buffer
) HeapFree( GetProcessHeap(), 0, buf_ptr
);
4183 ClosePredefKey(hkey
);
4184 return RtlNtStatusToDosError(status
);
4188 /************************************************************************
4193 LSTATUS WINAPI
RegQueryValueA( HKEY hkey
, LPCSTR name
, LPSTR data
, LPLONG count
)
4198 TRACE("(%p,%s,%p,%d)\n", hkey
, debugstr_a(name
), data
, count
? *count
: 0 );
4200 if (name
&& name
[0])
4202 if ((ret
= RegOpenKeyA( hkey
, name
, &subkey
)) != ERROR_SUCCESS
) return ret
;
4204 ret
= RegQueryValueExA( subkey
, NULL
, NULL
, NULL
, (LPBYTE
)data
, (LPDWORD
)count
);
4205 if (subkey
!= hkey
) RegCloseKey( subkey
);
4206 if (ret
== ERROR_FILE_NOT_FOUND
)
4208 /* return empty string if default value not found */
4209 if (data
) *data
= 0;
4210 if (count
) *count
= 1;
4211 ret
= ERROR_SUCCESS
;
4217 /************************************************************************
4222 LSTATUS WINAPI
RegQueryValueW( HKEY hkey
, LPCWSTR name
, LPWSTR data
, LPLONG count
)
4227 TRACE("(%p,%s,%p,%d)\n", hkey
, debugstr_w(name
), data
, count
? *count
: 0 );
4230 return ERROR_INVALID_HANDLE
;
4232 if (name
&& name
[0])
4234 ret
= RegOpenKeyW( hkey
, name
, &subkey
);
4235 if (ret
!= ERROR_SUCCESS
)
4241 ret
= RegQueryValueExW( subkey
, NULL
, NULL
, NULL
, (LPBYTE
)data
, (LPDWORD
)count
);
4245 RegCloseKey( subkey
);
4248 if (ret
== ERROR_FILE_NOT_FOUND
)
4250 /* return empty string if default value not found */
4254 *count
= sizeof(WCHAR
);
4255 ret
= ERROR_SUCCESS
;
4261 /************************************************************************
4267 RegReplaceKeyA(HKEY hKey
,
4272 UNICODE_STRING SubKey
;
4273 UNICODE_STRING NewFile
;
4274 UNICODE_STRING OldFile
;
4277 RtlInitEmptyUnicodeString(&SubKey
, NULL
, 0);
4278 RtlInitEmptyUnicodeString(&OldFile
, NULL
, 0);
4279 RtlInitEmptyUnicodeString(&NewFile
, NULL
, 0);
4283 if (!RtlCreateUnicodeStringFromAsciiz(&SubKey
, lpSubKey
))
4285 ErrorCode
= ERROR_NOT_ENOUGH_MEMORY
;
4292 if (!RtlCreateUnicodeStringFromAsciiz(&OldFile
, lpOldFile
))
4294 ErrorCode
= ERROR_NOT_ENOUGH_MEMORY
;
4301 if (!RtlCreateUnicodeStringFromAsciiz(&NewFile
, lpNewFile
))
4303 ErrorCode
= ERROR_NOT_ENOUGH_MEMORY
;
4308 ErrorCode
= RegReplaceKeyW(hKey
,
4314 RtlFreeUnicodeString(&OldFile
);
4315 RtlFreeUnicodeString(&NewFile
);
4316 RtlFreeUnicodeString(&SubKey
);
4322 /************************************************************************
4328 RegReplaceKeyW(HKEY hKey
,
4333 OBJECT_ATTRIBUTES KeyObjectAttributes
;
4334 OBJECT_ATTRIBUTES NewObjectAttributes
;
4335 OBJECT_ATTRIBUTES OldObjectAttributes
;
4336 UNICODE_STRING SubKeyName
;
4337 UNICODE_STRING NewFileName
;
4338 UNICODE_STRING OldFileName
;
4339 BOOLEAN CloseRealKey
;
4340 HANDLE RealKeyHandle
;
4343 LONG ErrorCode
= ERROR_SUCCESS
;
4345 if (hKey
== HKEY_PERFORMANCE_DATA
)
4347 return ERROR_INVALID_HANDLE
;
4350 Status
= MapDefaultKey(&KeyHandle
,
4352 if (!NT_SUCCESS(Status
))
4354 return RtlNtStatusToDosError(Status
);
4357 /* Open the real key */
4358 if (lpSubKey
!= NULL
&& *lpSubKey
!= (WCHAR
)0)
4360 RtlInitUnicodeString(&SubKeyName
,
4362 InitializeObjectAttributes(&KeyObjectAttributes
,
4364 OBJ_CASE_INSENSITIVE
,
4367 Status
= NtOpenKey(&RealKeyHandle
,
4369 &KeyObjectAttributes
);
4370 if (!NT_SUCCESS(Status
))
4372 ErrorCode
= RtlNtStatusToDosError(Status
);
4376 CloseRealKey
= TRUE
;
4380 RealKeyHandle
= KeyHandle
;
4381 CloseRealKey
= FALSE
;
4384 /* Convert new file name */
4385 if (!RtlDosPathNameToNtPathName_U(lpNewFile
,
4392 NtClose(RealKeyHandle
);
4395 ErrorCode
= ERROR_INVALID_PARAMETER
;
4399 InitializeObjectAttributes(&NewObjectAttributes
,
4401 OBJ_CASE_INSENSITIVE
,
4405 /* Convert old file name */
4406 if (!RtlDosPathNameToNtPathName_U(lpOldFile
,
4411 RtlFreeHeap(RtlGetProcessHeap (),
4413 NewFileName
.Buffer
);
4416 NtClose(RealKeyHandle
);
4419 ErrorCode
= ERROR_INVALID_PARAMETER
;
4423 InitializeObjectAttributes(&OldObjectAttributes
,
4425 OBJ_CASE_INSENSITIVE
,
4429 Status
= NtReplaceKey(&NewObjectAttributes
,
4431 &OldObjectAttributes
);
4433 RtlFreeHeap(RtlGetProcessHeap(),
4435 OldFileName
.Buffer
);
4436 RtlFreeHeap(RtlGetProcessHeap(),
4438 NewFileName
.Buffer
);
4442 NtClose(RealKeyHandle
);
4445 if (!NT_SUCCESS(Status
))
4447 return RtlNtStatusToDosError(Status
);
4451 ClosePredefKey(KeyHandle
);
4457 /************************************************************************
4463 RegRestoreKeyA(HKEY hKey
,
4467 UNICODE_STRING FileName
;
4472 if (!RtlCreateUnicodeStringFromAsciiz(&FileName
, lpFile
))
4473 return ERROR_NOT_ENOUGH_MEMORY
;
4476 RtlInitEmptyUnicodeString(&FileName
, NULL
, 0);
4478 ErrorCode
= RegRestoreKeyW(hKey
,
4482 RtlFreeUnicodeString(&FileName
);
4488 /************************************************************************
4494 RegRestoreKeyW(HKEY hKey
,
4498 OBJECT_ATTRIBUTES ObjectAttributes
;
4499 IO_STATUS_BLOCK IoStatusBlock
;
4500 UNICODE_STRING FileName
;
4505 if (hKey
== HKEY_PERFORMANCE_DATA
)
4507 return ERROR_INVALID_HANDLE
;
4510 Status
= MapDefaultKey(&KeyHandle
,
4512 if (!NT_SUCCESS(Status
))
4514 return RtlNtStatusToDosError(Status
);
4517 if (!RtlDosPathNameToNtPathName_U(lpFile
,
4522 Status
= STATUS_INVALID_PARAMETER
;
4526 InitializeObjectAttributes(&ObjectAttributes
,
4528 OBJ_CASE_INSENSITIVE
,
4532 Status
= NtOpenFile(&FileHandle
,
4537 FILE_SYNCHRONOUS_IO_NONALERT
);
4538 RtlFreeHeap(RtlGetProcessHeap(),
4541 if (!NT_SUCCESS(Status
))
4546 Status
= NtRestoreKey(KeyHandle
,
4549 NtClose (FileHandle
);
4552 ClosePredefKey(KeyHandle
);
4554 if (!NT_SUCCESS(Status
))
4556 return RtlNtStatusToDosError(Status
);
4559 return ERROR_SUCCESS
;
4563 /************************************************************************
4569 RegSaveKeyA(HKEY hKey
,
4571 LPSECURITY_ATTRIBUTES lpSecurityAttributes
)
4573 UNICODE_STRING FileName
;
4578 if (!RtlCreateUnicodeStringFromAsciiz(&FileName
, lpFile
))
4579 return ERROR_NOT_ENOUGH_MEMORY
;
4582 RtlInitEmptyUnicodeString(&FileName
, NULL
, 0);
4584 ErrorCode
= RegSaveKeyW(hKey
,
4586 lpSecurityAttributes
);
4587 RtlFreeUnicodeString(&FileName
);
4593 /************************************************************************
4599 RegSaveKeyW(HKEY hKey
,
4601 LPSECURITY_ATTRIBUTES lpSecurityAttributes
)
4603 PSECURITY_DESCRIPTOR SecurityDescriptor
= NULL
;
4604 OBJECT_ATTRIBUTES ObjectAttributes
;
4605 UNICODE_STRING FileName
;
4606 IO_STATUS_BLOCK IoStatusBlock
;
4611 Status
= MapDefaultKey(&KeyHandle
,
4613 if (!NT_SUCCESS(Status
))
4615 return RtlNtStatusToDosError(Status
);
4618 if (!RtlDosPathNameToNtPathName_U(lpFile
,
4623 Status
= STATUS_INVALID_PARAMETER
;
4627 if (lpSecurityAttributes
!= NULL
)
4629 SecurityDescriptor
= lpSecurityAttributes
->lpSecurityDescriptor
;
4632 InitializeObjectAttributes(&ObjectAttributes
,
4634 OBJ_CASE_INSENSITIVE
,
4636 SecurityDescriptor
);
4637 Status
= NtCreateFile(&FileHandle
,
4638 GENERIC_WRITE
| SYNCHRONIZE
,
4642 FILE_ATTRIBUTE_NORMAL
,
4645 FILE_OPEN_FOR_BACKUP_INTENT
| FILE_SYNCHRONOUS_IO_NONALERT
,
4648 RtlFreeHeap(RtlGetProcessHeap(),
4651 if (!NT_SUCCESS(Status
))
4656 Status
= NtSaveKey(KeyHandle
,
4658 NtClose (FileHandle
);
4661 ClosePredefKey(KeyHandle
);
4663 if (!NT_SUCCESS(Status
))
4665 return RtlNtStatusToDosError(Status
);
4668 return ERROR_SUCCESS
;
4672 /************************************************************************
4679 RegSaveKeyExA(HKEY hKey
,
4681 LPSECURITY_ATTRIBUTES lpSecurityAttributes
,
4684 UNICODE_STRING FileName
;
4689 if (!RtlCreateUnicodeStringFromAsciiz(&FileName
, lpFile
))
4690 return ERROR_NOT_ENOUGH_MEMORY
;
4693 RtlInitEmptyUnicodeString(&FileName
, NULL
, 0);
4695 ErrorCode
= RegSaveKeyExW(hKey
,
4697 lpSecurityAttributes
,
4699 RtlFreeUnicodeString(&FileName
);
4705 /************************************************************************
4712 RegSaveKeyExW(HKEY hKey
,
4714 LPSECURITY_ATTRIBUTES lpSecurityAttributes
,
4719 case REG_STANDARD_FORMAT
:
4720 case REG_LATEST_FORMAT
:
4721 case REG_NO_COMPRESSION
:
4724 return ERROR_INVALID_PARAMETER
;
4727 FIXME("RegSaveKeyExW(): Flags ignored!\n");
4729 return RegSaveKeyW(hKey
,
4731 lpSecurityAttributes
);
4735 /************************************************************************
4741 RegSetKeySecurity(HKEY hKey
,
4742 SECURITY_INFORMATION SecurityInformation
,
4743 PSECURITY_DESCRIPTOR pSecurityDescriptor
)
4748 if (hKey
== HKEY_PERFORMANCE_DATA
)
4750 return ERROR_INVALID_HANDLE
;
4753 Status
= MapDefaultKey(&KeyHandle
,
4755 if (!NT_SUCCESS(Status
))
4757 return RtlNtStatusToDosError(Status
);
4760 Status
= NtSetSecurityObject(KeyHandle
,
4761 SecurityInformation
,
4762 pSecurityDescriptor
);
4764 ClosePredefKey(KeyHandle
);
4766 if (!NT_SUCCESS(Status
))
4768 return RtlNtStatusToDosError(Status
);
4771 return ERROR_SUCCESS
;
4775 /************************************************************************
4781 RegSetValueExA(HKEY hKey
,
4788 UNICODE_STRING ValueName
;
4790 ANSI_STRING AnsiString
;
4791 UNICODE_STRING Data
;
4797 /* Convert SubKey name to Unicode */
4798 if (lpValueName
!= NULL
&& lpValueName
[0] != '\0')
4801 bConverted
= RtlCreateUnicodeStringFromAsciiz(&ValueName
,
4804 return ERROR_NOT_ENOUGH_MEMORY
;
4808 ValueName
.Buffer
= NULL
;
4811 pValueName
= (LPWSTR
)ValueName
.Buffer
;
4814 if (is_string(dwType
) && (cbData
!= 0))
4816 /* Convert ANSI string Data to Unicode */
4817 /* If last character NOT zero then increment length */
4818 LONG bNoNulledStr
= ((lpData
[cbData
-1] != '\0') ? 1 : 0);
4819 AnsiString
.Buffer
= (PSTR
)lpData
;
4820 AnsiString
.Length
= cbData
+ bNoNulledStr
;
4821 AnsiString
.MaximumLength
= cbData
+ bNoNulledStr
;
4822 Status
= RtlAnsiStringToUnicodeString(&Data
,
4826 if (!NT_SUCCESS(Status
))
4828 if (pValueName
!= NULL
)
4829 RtlFreeUnicodeString(&ValueName
);
4831 return RtlNtStatusToDosError(Status
);
4833 pData
= (LPBYTE
)Data
.Buffer
;
4834 DataSize
= cbData
* sizeof(WCHAR
);
4839 pData
= (LPBYTE
)lpData
;
4843 ErrorCode
= RegSetValueExW(hKey
,
4850 if (pValueName
!= NULL
)
4851 RtlFreeUnicodeString(&ValueName
);
4853 if (Data
.Buffer
!= NULL
)
4854 RtlFreeUnicodeString(&Data
);
4860 /************************************************************************
4869 _In_ LPCWSTR lpValueName
,
4870 _In_ DWORD Reserved
,
4872 _In_ CONST BYTE
* lpData
,
4875 UNICODE_STRING ValueName
;
4879 Status
= MapDefaultKey(&KeyHandle
,
4881 if (!NT_SUCCESS(Status
))
4883 return RtlNtStatusToDosError(Status
);
4886 if (IsHKCRKey(KeyHandle
))
4888 LONG ErrorCode
= SetHKCRValue(KeyHandle
, lpValueName
, Reserved
, dwType
, lpData
, cbData
);
4889 ClosePredefKey(KeyHandle
);
4893 if (is_string(dwType
) && (cbData
!= 0))
4895 PWSTR pwsData
= (PWSTR
)lpData
;
4899 if((pwsData
[cbData
/ sizeof(WCHAR
) - 1] != L
'\0') &&
4900 (pwsData
[cbData
/ sizeof(WCHAR
)] == L
'\0'))
4902 /* Increment length if last character is not zero and next is zero */
4903 cbData
+= sizeof(WCHAR
);
4906 _SEH2_EXCEPT(EXCEPTION_EXECUTE_HANDLER
)
4908 ClosePredefKey(KeyHandle
);
4909 return ERROR_NOACCESS
;
4914 RtlInitUnicodeString(&ValueName
, lpValueName
);
4916 Status
= NtSetValueKey(KeyHandle
,
4923 ClosePredefKey(KeyHandle
);
4925 if (!NT_SUCCESS(Status
))
4927 return RtlNtStatusToDosError(Status
);
4930 return ERROR_SUCCESS
;
4934 /************************************************************************
4940 RegSetValueA(HKEY hKeyOriginal
,
4951 TRACE("(%p,%s,%d,%s,%d)\n", hKeyOriginal
, debugstr_a(lpSubKey
), dwType
, debugstr_a(lpData
), cbData
);
4953 if (dwType
!= REG_SZ
|| !lpData
) return ERROR_INVALID_PARAMETER
;
4955 Status
= MapDefaultKey(&hKey
, hKeyOriginal
);
4956 if (!NT_SUCCESS(Status
))
4958 return RtlNtStatusToDosError (Status
);
4962 if (lpSubKey
&& lpSubKey
[0]) /* need to create the subkey */
4964 ret
= RegCreateKeyA(hKey
, lpSubKey
, &subkey
);
4965 if (ret
!= ERROR_SUCCESS
)
4969 ret
= RegSetValueExA( subkey
, NULL
, 0, REG_SZ
, (const BYTE
*)lpData
, strlen(lpData
)+1 );
4971 RegCloseKey(subkey
);
4974 ClosePredefKey(hKey
);
4980 /************************************************************************
4986 RegSetValueW(HKEY hKeyOriginal
,
4997 TRACE("(%p,%s,%d,%s,%d)\n", hKeyOriginal
, debugstr_w(lpSubKey
), dwType
, debugstr_w(lpData
), cbData
);
4999 if (dwType
!= REG_SZ
|| !lpData
)
5000 return ERROR_INVALID_PARAMETER
;
5002 Status
= MapDefaultKey(&hKey
,
5004 if (!NT_SUCCESS(Status
))
5006 return RtlNtStatusToDosError(Status
);
5010 if (lpSubKey
&& lpSubKey
[0]) /* need to create the subkey */
5012 ret
= RegCreateKeyW(hKey
, lpSubKey
, &subkey
);
5013 if (ret
!= ERROR_SUCCESS
)
5017 ret
= RegSetValueExW( subkey
, NULL
, 0, REG_SZ
, (const BYTE
*)lpData
,
5018 (wcslen( lpData
) + 1) * sizeof(WCHAR
) );
5020 RegCloseKey(subkey
);
5023 ClosePredefKey(hKey
);
5029 /************************************************************************
5035 RegUnLoadKeyA(HKEY hKey
,
5038 UNICODE_STRING KeyName
;
5043 if (!RtlCreateUnicodeStringFromAsciiz(&KeyName
, lpSubKey
))
5044 return ERROR_NOT_ENOUGH_MEMORY
;
5047 RtlInitEmptyUnicodeString(&KeyName
, NULL
, 0);
5049 ErrorCode
= RegUnLoadKeyW(hKey
,
5052 RtlFreeUnicodeString (&KeyName
);
5058 /************************************************************************
5064 RegUnLoadKeyW(HKEY hKey
,
5067 OBJECT_ATTRIBUTES ObjectAttributes
;
5068 UNICODE_STRING KeyName
;
5072 if (hKey
== HKEY_PERFORMANCE_DATA
)
5074 return ERROR_INVALID_HANDLE
;
5077 Status
= MapDefaultKey(&KeyHandle
, hKey
);
5078 if (!NT_SUCCESS(Status
))
5080 return RtlNtStatusToDosError(Status
);
5083 RtlInitUnicodeString(&KeyName
,
5086 InitializeObjectAttributes(&ObjectAttributes
,
5088 OBJ_CASE_INSENSITIVE
,
5092 Status
= NtUnloadKey(&ObjectAttributes
);
5094 ClosePredefKey(KeyHandle
);
5096 if (!NT_SUCCESS(Status
))
5098 return RtlNtStatusToDosError(Status
);
5101 return ERROR_SUCCESS
;
5105 /******************************************************************************
5106 * load_string [Internal]
5108 * This is basically a copy of user32/resource.c's LoadStringW. Necessary to
5109 * avoid importing user32, which is higher level than advapi32. Helper for
5112 static int load_string(HINSTANCE hModule
, UINT resId
, LPWSTR pwszBuffer
, INT cMaxChars
)
5119 /* Negative values have to be inverted. */
5120 if (HIWORD(resId
) == 0xffff)
5121 resId
= (UINT
)(-((INT
)resId
));
5123 /* Load the resource into memory and get a pointer to it. */
5124 hResource
= FindResourceW(hModule
, MAKEINTRESOURCEW(LOWORD(resId
>> 4) + 1), (LPWSTR
)RT_STRING
);
5125 if (!hResource
) return 0;
5126 hMemory
= LoadResource(hModule
, hResource
);
5127 if (!hMemory
) return 0;
5128 pString
= LockResource(hMemory
);
5130 /* Strings are length-prefixed. Lowest nibble of resId is an index. */
5131 idxString
= resId
& 0xf;
5132 while (idxString
--) pString
+= *pString
+ 1;
5134 /* If no buffer is given, return length of the string. */
5135 if (!pwszBuffer
) return *pString
;
5137 /* Else copy over the string, respecting the buffer size. */
5138 cMaxChars
= (*pString
< cMaxChars
) ? *pString
: (cMaxChars
- 1);
5141 memcpy(pwszBuffer
, pString
+1, cMaxChars
* sizeof(WCHAR
));
5142 pwszBuffer
[cMaxChars
] = L
'\0';
5149 /************************************************************************
5155 RegLoadMUIStringW(IN HKEY hKey
,
5156 IN LPCWSTR pszValue OPTIONAL
,
5157 OUT LPWSTR pszOutBuf
,
5159 OUT LPDWORD pcbData OPTIONAL
,
5161 IN LPCWSTR pszDirectory OPTIONAL
)
5163 DWORD dwValueType
, cbData
;
5164 LPWSTR pwszTempBuffer
= NULL
, pwszExpandedBuffer
= NULL
;
5167 /* Parameter sanity checks. */
5168 if (!hKey
|| !pszOutBuf
)
5169 return ERROR_INVALID_PARAMETER
;
5171 if (pszDirectory
&& *pszDirectory
)
5173 FIXME("BaseDir parameter not yet supported!\n");
5174 return ERROR_INVALID_PARAMETER
;
5177 /* Check for value existence and correctness of it's type, allocate a buffer and load it. */
5178 result
= RegQueryValueExW(hKey
, pszValue
, NULL
, &dwValueType
, NULL
, &cbData
);
5179 if (result
!= ERROR_SUCCESS
) goto cleanup
;
5180 if (!(dwValueType
== REG_SZ
|| dwValueType
== REG_EXPAND_SZ
) || !cbData
)
5182 result
= ERROR_FILE_NOT_FOUND
;
5185 pwszTempBuffer
= HeapAlloc(GetProcessHeap(), 0, cbData
);
5186 if (!pwszTempBuffer
)
5188 result
= ERROR_NOT_ENOUGH_MEMORY
;
5191 result
= RegQueryValueExW(hKey
, pszValue
, NULL
, &dwValueType
, (LPBYTE
)pwszTempBuffer
, &cbData
);
5192 if (result
!= ERROR_SUCCESS
) goto cleanup
;
5194 /* Expand environment variables, if appropriate, or copy the original string over. */
5195 if (dwValueType
== REG_EXPAND_SZ
)
5197 cbData
= ExpandEnvironmentStringsW(pwszTempBuffer
, NULL
, 0) * sizeof(WCHAR
);
5198 if (!cbData
) goto cleanup
;
5199 pwszExpandedBuffer
= HeapAlloc(GetProcessHeap(), 0, cbData
);
5200 if (!pwszExpandedBuffer
)
5202 result
= ERROR_NOT_ENOUGH_MEMORY
;
5205 ExpandEnvironmentStringsW(pwszTempBuffer
, pwszExpandedBuffer
, cbData
);
5209 pwszExpandedBuffer
= HeapAlloc(GetProcessHeap(), 0, cbData
);
5210 memcpy(pwszExpandedBuffer
, pwszTempBuffer
, cbData
);
5213 /* If the value references a resource based string, parse the value and load the string.
5214 * Else just copy over the original value. */
5215 result
= ERROR_SUCCESS
;
5216 if (*pwszExpandedBuffer
!= L
'@') /* '@' is the prefix for resource based string entries. */
5218 lstrcpynW(pszOutBuf
, pwszExpandedBuffer
, cbOutBuf
/ sizeof(WCHAR
));
5222 WCHAR
*pComma
= wcsrchr(pwszExpandedBuffer
, L
',');
5226 /* Format of the expanded value is 'path_to_dll,-resId' */
5227 if (!pComma
|| pComma
[1] != L
'-')
5229 result
= ERROR_BADKEY
;
5233 uiStringId
= _wtoi(pComma
+2);
5236 hModule
= LoadLibraryExW(pwszExpandedBuffer
+ 1, NULL
, LOAD_LIBRARY_AS_DATAFILE
);
5237 if (!hModule
|| !load_string(hModule
, uiStringId
, pszOutBuf
, cbOutBuf
/ sizeof(WCHAR
)))
5238 result
= ERROR_BADKEY
;
5239 FreeLibrary(hModule
);
5243 HeapFree(GetProcessHeap(), 0, pwszTempBuffer
);
5244 HeapFree(GetProcessHeap(), 0, pwszExpandedBuffer
);
5249 /************************************************************************
5255 RegLoadMUIStringA(IN HKEY hKey
,
5256 IN LPCSTR pszValue OPTIONAL
,
5257 OUT LPSTR pszOutBuf
,
5259 OUT LPDWORD pcbData OPTIONAL
,
5261 IN LPCSTR pszDirectory OPTIONAL
)
5263 UNICODE_STRING valueW
, baseDirW
;
5265 DWORD cbData
= cbOutBuf
* sizeof(WCHAR
);
5268 valueW
.Buffer
= baseDirW
.Buffer
= pwszBuffer
= NULL
;
5269 if (!RtlCreateUnicodeStringFromAsciiz(&valueW
, pszValue
) ||
5270 !RtlCreateUnicodeStringFromAsciiz(&baseDirW
, pszDirectory
) ||
5271 !(pwszBuffer
= HeapAlloc(GetProcessHeap(), 0, cbData
)))
5273 result
= ERROR_NOT_ENOUGH_MEMORY
;
5277 result
= RegLoadMUIStringW(hKey
, valueW
.Buffer
, pwszBuffer
, cbData
, NULL
, Flags
,
5280 if (result
== ERROR_SUCCESS
)
5282 cbData
= WideCharToMultiByte(CP_ACP
, 0, pwszBuffer
, -1, pszOutBuf
, cbOutBuf
, NULL
, NULL
);
5288 HeapFree(GetProcessHeap(), 0, pwszBuffer
);
5289 RtlFreeUnicodeString(&baseDirW
);
5290 RtlFreeUnicodeString(&valueW
);