user32: Avoid dereferencing NULL pointer in a trace.
[wine.git] / include / winreg.h
blobcf6bd475b5441488b00202f7567cb0635b4f4ac9
1 /*
2 * Win32 registry defines (see also winnt.h)
4 * Copyright (C) the Wine project
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
21 #ifndef __WINE_WINREG_H
22 #define __WINE_WINREG_H
24 #ifdef __cplusplus
25 extern "C" {
26 #endif /* defined(__cplusplus) */
28 #define HKEY_CLASSES_ROOT ((HKEY)(LONG_PTR)(LONG)0x80000000)
29 #define HKEY_CURRENT_USER ((HKEY)(LONG_PTR)(LONG)0x80000001)
30 #define HKEY_LOCAL_MACHINE ((HKEY)(LONG_PTR)(LONG)0x80000002)
31 #define HKEY_USERS ((HKEY)(LONG_PTR)(LONG)0x80000003)
32 #define HKEY_PERFORMANCE_DATA ((HKEY)(LONG_PTR)(LONG)0x80000004)
33 #define HKEY_CURRENT_CONFIG ((HKEY)(LONG_PTR)(LONG)0x80000005)
34 #define HKEY_DYN_DATA ((HKEY)(LONG_PTR)(LONG)0x80000006)
37 * registry provider structs
39 typedef struct value_entA
40 { LPSTR ve_valuename;
41 DWORD ve_valuelen;
42 DWORD_PTR ve_valueptr;
43 DWORD ve_type;
44 } VALENTA, *PVALENTA;
46 typedef struct value_entW {
47 LPWSTR ve_valuename;
48 DWORD ve_valuelen;
49 DWORD_PTR ve_valueptr;
50 DWORD ve_type;
51 } VALENTW, *PVALENTW;
53 typedef ACCESS_MASK REGSAM;
54 typedef LONG LSTATUS;
57 * InitiateSystemShutdown() reasons
59 #include <reason.h>
61 #define REASON_OTHER (SHTDN_REASON_MAJOR_OTHER | SHTDN_REASON_MINOR_OTHER)
62 #define REASON_UNKNOWN SHTDN_REASON_UNKNOWN
63 #define REASON_LEGACY_API SHTDN_REASON_LEGACY_API
64 #define REASON_PLANNED_FLAG SHTDN_REASON_FLAG_PLANNED
66 #define MAX_SHUTDOWN_TIMEOUT (10*365*24*60*60)
69 * RegGetValue() restrictions
72 #define RRF_RT_REG_NONE (1 << 0)
73 #define RRF_RT_REG_SZ (1 << 1)
74 #define RRF_RT_REG_EXPAND_SZ (1 << 2)
75 #define RRF_RT_REG_BINARY (1 << 3)
76 #define RRF_RT_REG_DWORD (1 << 4)
77 #define RRF_RT_REG_MULTI_SZ (1 << 5)
78 #define RRF_RT_REG_QWORD (1 << 6)
79 #define RRF_RT_DWORD (RRF_RT_REG_BINARY | RRF_RT_REG_DWORD)
80 #define RRF_RT_QWORD (RRF_RT_REG_BINARY | RRF_RT_REG_QWORD)
81 #define RRF_RT_ANY 0xffff
82 #define RRF_NOEXPAND (1 << 28)
83 #define RRF_ZEROONFAILURE (1 << 29)
85 WINADVAPI BOOL WINAPI AbortSystemShutdownA(LPSTR);
86 WINADVAPI BOOL WINAPI AbortSystemShutdownW(LPWSTR);
87 #define AbortSystemShutdown WINELIB_NAME_AW(AbortSystemShutdown)
88 WINADVAPI BOOL WINAPI InitiateSystemShutdownA(LPSTR,LPSTR,DWORD,BOOL,BOOL);
89 WINADVAPI BOOL WINAPI InitiateSystemShutdownW(LPWSTR,LPWSTR,DWORD,BOOL,BOOL);
90 #define InitiateSystemShutdown WINELIB_NAME_AW(InitiateSystemShutdown)
91 WINADVAPI BOOL WINAPI InitiateSystemShutdownExA(LPSTR,LPSTR,DWORD,BOOL,BOOL,DWORD);
92 WINADVAPI BOOL WINAPI InitiateSystemShutdownExW(LPWSTR,LPWSTR,DWORD,BOOL,BOOL,DWORD);
93 #define InitiateSystemShutdownEx WINELIB_NAME_AW(InitiateSystemShutdownEx)
94 WINADVAPI LSTATUS WINAPI RegCloseKey(HKEY);
95 WINADVAPI LSTATUS WINAPI RegConnectRegistryA(LPCSTR,HKEY,PHKEY);
96 WINADVAPI LSTATUS WINAPI RegConnectRegistryW(LPCWSTR,HKEY,PHKEY);
97 #define RegConnectRegistry WINELIB_NAME_AW(RegConnectRegistry)
98 WINADVAPI LSTATUS WINAPI RegCreateKeyA(HKEY,LPCSTR,PHKEY);
99 WINADVAPI LSTATUS WINAPI RegCreateKeyW(HKEY,LPCWSTR,PHKEY);
100 #define RegCreateKey WINELIB_NAME_AW(RegCreateKey)
101 WINADVAPI LSTATUS WINAPI RegCreateKeyExA(HKEY,LPCSTR,DWORD,LPSTR,DWORD,REGSAM,LPSECURITY_ATTRIBUTES,PHKEY,LPDWORD);
102 WINADVAPI LSTATUS WINAPI RegCreateKeyExW(HKEY,LPCWSTR,DWORD,LPWSTR,DWORD,REGSAM,LPSECURITY_ATTRIBUTES,PHKEY,LPDWORD);
103 #define RegCreateKeyEx WINELIB_NAME_AW(RegCreateKeyEx)
104 WINADVAPI LSTATUS WINAPI RegDeleteKeyA(HKEY,LPCSTR);
105 WINADVAPI LSTATUS WINAPI RegDeleteKeyW(HKEY,LPCWSTR);
106 #define RegDeleteKey WINELIB_NAME_AW(RegDeleteKey)
107 WINADVAPI LSTATUS WINAPI RegDeleteKeyExA(HKEY,LPCSTR,REGSAM,DWORD);
108 WINADVAPI LSTATUS WINAPI RegDeleteKeyExW(HKEY,LPCWSTR,REGSAM,DWORD);
109 #define RegDeleteKeyEx WINELIB_NAME_AW(RegDeleteKeyEx)
110 WINADVAPI LSTATUS WINAPI RegDeleteKeyValueA(HKEY,LPCSTR,LPCSTR);
111 WINADVAPI LSTATUS WINAPI RegDeleteKeyValueW(HKEY,LPCWSTR,LPCWSTR);
112 #define RegDeleteKeyValue WINELIB_NAME_AW(RegDeleteKeyValue)
113 WINADVAPI LSTATUS WINAPI RegDeleteTreeA(HKEY,LPCSTR);
114 WINADVAPI LSTATUS WINAPI RegDeleteTreeW(HKEY,LPCWSTR);
115 #define RegDeleteTree WINELIB_NAME_AW(RegDeleteTree)
116 WINADVAPI LSTATUS WINAPI RegDeleteValueA(HKEY,LPCSTR);
117 WINADVAPI LSTATUS WINAPI RegDeleteValueW(HKEY,LPCWSTR);
118 #define RegDeleteValue WINELIB_NAME_AW(RegDeleteValue)
119 WINADVAPI LSTATUS WINAPI RegDisablePredefinedCache(void);
120 WINADVAPI LSTATUS WINAPI RegEnumKeyA(HKEY,DWORD,LPSTR,DWORD);
121 WINADVAPI LSTATUS WINAPI RegEnumKeyW(HKEY,DWORD,LPWSTR,DWORD);
122 #define RegEnumKey WINELIB_NAME_AW(RegEnumKey)
123 WINADVAPI LSTATUS WINAPI RegEnumKeyExA(HKEY,DWORD,LPSTR,LPDWORD,LPDWORD,LPSTR,LPDWORD,LPFILETIME);
124 WINADVAPI LSTATUS WINAPI RegEnumKeyExW(HKEY,DWORD,LPWSTR,LPDWORD,LPDWORD,LPWSTR,LPDWORD,LPFILETIME);
125 #define RegEnumKeyEx WINELIB_NAME_AW(RegEnumKeyEx)
126 WINADVAPI LSTATUS WINAPI RegEnumValueA(HKEY,DWORD,LPSTR,LPDWORD,LPDWORD,LPDWORD,LPBYTE,LPDWORD);
127 WINADVAPI LSTATUS WINAPI RegEnumValueW(HKEY,DWORD,LPWSTR,LPDWORD,LPDWORD,LPDWORD,LPBYTE,LPDWORD);
128 #define RegEnumValue WINELIB_NAME_AW(RegEnumValue)
129 WINADVAPI LSTATUS WINAPI RegFlushKey(HKEY);
130 WINADVAPI LSTATUS WINAPI RegGetKeySecurity(HKEY,SECURITY_INFORMATION,PSECURITY_DESCRIPTOR,LPDWORD);
131 WINADVAPI LSTATUS WINAPI RegGetValueA(HKEY,LPCSTR,LPCSTR,DWORD,LPDWORD,PVOID,LPDWORD);
132 WINADVAPI LSTATUS WINAPI RegGetValueW(HKEY,LPCWSTR,LPCWSTR,DWORD,LPDWORD,PVOID,LPDWORD);
133 #define RegGetValue WINELIB_NAME_AW(RegGetValue)
134 WINADVAPI LSTATUS WINAPI RegLoadKeyA(HKEY,LPCSTR,LPCSTR);
135 WINADVAPI LSTATUS WINAPI RegLoadKeyW(HKEY,LPCWSTR,LPCWSTR);
136 #define RegLoadKey WINELIB_NAME_AW(RegLoadKey)
137 WINADVAPI LSTATUS WINAPI RegLoadMUIStringA(HKEY,LPCSTR,LPSTR,DWORD,LPDWORD,DWORD,LPCSTR);
138 WINADVAPI LSTATUS WINAPI RegLoadMUIStringW(HKEY,LPCWSTR,LPWSTR,DWORD,LPDWORD,DWORD,LPCWSTR);
139 #define RegLoadMUIString WINELIB_NAME_AW(RegLoadMUIString)
140 WINADVAPI LSTATUS WINAPI RegNotifyChangeKeyValue(HKEY,BOOL,DWORD,HANDLE,BOOL);
141 WINADVAPI LSTATUS WINAPI RegOpenCurrentUser(REGSAM,PHKEY);
142 WINADVAPI LSTATUS WINAPI RegOpenKeyA(HKEY,LPCSTR,PHKEY);
143 WINADVAPI LSTATUS WINAPI RegOpenKeyW(HKEY,LPCWSTR,PHKEY);
144 #define RegOpenKey WINELIB_NAME_AW(RegOpenKey)
145 WINADVAPI LSTATUS WINAPI RegOpenKeyExW(HKEY,LPCWSTR,DWORD,REGSAM,PHKEY);
146 WINADVAPI LSTATUS WINAPI RegOpenKeyExA(HKEY,LPCSTR,DWORD,REGSAM,PHKEY);
147 #define RegOpenKeyEx WINELIB_NAME_AW(RegOpenKeyEx)
148 WINADVAPI LSTATUS WINAPI RegOpenUserClassesRoot(HANDLE,DWORD,REGSAM,PHKEY);
149 WINADVAPI LSTATUS WINAPI RegOverridePredefKey(HKEY,HKEY);
150 WINADVAPI LSTATUS WINAPI RegQueryInfoKeyW(HKEY,LPWSTR,LPDWORD,LPDWORD,LPDWORD,LPDWORD,LPDWORD,LPDWORD,LPDWORD,LPDWORD,LPDWORD,LPFILETIME);
151 WINADVAPI LSTATUS WINAPI RegQueryInfoKeyA(HKEY,LPSTR,LPDWORD,LPDWORD,LPDWORD,LPDWORD,LPDWORD,LPDWORD,LPDWORD,LPDWORD,LPDWORD,LPFILETIME);
152 #define RegQueryInfoKey WINELIB_NAME_AW(RegQueryInfoKey)
153 WINADVAPI LSTATUS WINAPI RegQueryMultipleValuesA(HKEY,PVALENTA,DWORD,LPSTR,LPDWORD);
154 WINADVAPI LSTATUS WINAPI RegQueryMultipleValuesW(HKEY,PVALENTW,DWORD,LPWSTR,LPDWORD);
155 #define RegQueryMultipleValues WINELIB_NAME_AW(RegQueryMultipleValues)
156 WINADVAPI LSTATUS WINAPI RegQueryValueA(HKEY,LPCSTR,LPSTR,LPLONG);
157 WINADVAPI LSTATUS WINAPI RegQueryValueW(HKEY,LPCWSTR,LPWSTR,LPLONG);
158 #define RegQueryValue WINELIB_NAME_AW(RegQueryValue)
159 WINADVAPI LSTATUS WINAPI RegQueryValueExA(HKEY,LPCSTR,LPDWORD,LPDWORD,LPBYTE,LPDWORD);
160 WINADVAPI LSTATUS WINAPI RegQueryValueExW(HKEY,LPCWSTR,LPDWORD,LPDWORD,LPBYTE,LPDWORD);
161 #define RegQueryValueEx WINELIB_NAME_AW(RegQueryValueEx)
162 WINADVAPI LSTATUS WINAPI RegReplaceKeyA(HKEY,LPCSTR,LPCSTR,LPCSTR);
163 WINADVAPI LSTATUS WINAPI RegReplaceKeyW(HKEY,LPCWSTR,LPCWSTR,LPCWSTR);
164 #define RegReplaceKey WINELIB_NAME_AW(RegReplaceKey)
165 WINADVAPI LSTATUS WINAPI RegRestoreKeyA(HKEY,LPCSTR,DWORD);
166 WINADVAPI LSTATUS WINAPI RegRestoreKeyW(HKEY,LPCWSTR,DWORD);
167 #define RegRestoreKey WINELIB_NAME_AW(RegRestoreKey)
168 WINADVAPI LSTATUS WINAPI RegSaveKeyA(HKEY,LPCSTR,LPSECURITY_ATTRIBUTES);
169 WINADVAPI LSTATUS WINAPI RegSaveKeyW(HKEY,LPCWSTR,LPSECURITY_ATTRIBUTES);
170 #define RegSaveKey WINELIB_NAME_AW(RegSaveKey)
171 WINADVAPI LSTATUS WINAPI RegSetKeySecurity(HKEY,SECURITY_INFORMATION,PSECURITY_DESCRIPTOR);
172 WINADVAPI LSTATUS WINAPI RegSetKeyValueA(HKEY,LPCSTR,LPCSTR,DWORD,const void*,DWORD);
173 WINADVAPI LSTATUS WINAPI RegSetKeyValueW(HKEY,LPCWSTR,LPCWSTR,DWORD,const void*,DWORD);
174 WINADVAPI LSTATUS WINAPI RegSetValueA(HKEY,LPCSTR,DWORD,LPCSTR,DWORD);
175 WINADVAPI LSTATUS WINAPI RegSetValueW(HKEY,LPCWSTR,DWORD,LPCWSTR,DWORD);
176 #define RegSetValue WINELIB_NAME_AW(RegSetValue)
177 WINADVAPI LSTATUS WINAPI RegSetValueExA(HKEY,LPCSTR,DWORD,DWORD,const BYTE*,DWORD);
178 WINADVAPI LSTATUS WINAPI RegSetValueExW(HKEY,LPCWSTR,DWORD,DWORD,const BYTE*,DWORD);
179 #define RegSetValueEx WINELIB_NAME_AW(RegSetValueEx)
180 WINADVAPI LSTATUS WINAPI RegUnLoadKeyA(HKEY,LPCSTR);
181 WINADVAPI LSTATUS WINAPI RegUnLoadKeyW(HKEY,LPCWSTR);
182 #define RegUnLoadKey WINELIB_NAME_AW(RegUnLoadKey)
184 #ifdef __cplusplus
185 } /* extern "C" */
186 #endif /* defined(__cplusplus) */
188 #endif /* __WINE_WINREG_H */