advapi32: Add and use LSTATUS.
[wine] / include / winreg.h
1 /*
2  * Win32 registry defines (see also winnt.h)
3  *
4  * Copyright (C) the Wine project
5  *
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.
10  *
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.
15  *
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
19  */
20
21 #ifndef __WINE_WINREG_H
22 #define __WINE_WINREG_H
23
24 #ifdef __cplusplus
25 extern "C" {
26 #endif /* defined(__cplusplus) */
27
28 #define HKEY_CLASSES_ROOT       ((HKEY) 0x80000000)
29 #define HKEY_CURRENT_USER       ((HKEY) 0x80000001)
30 #define HKEY_LOCAL_MACHINE      ((HKEY) 0x80000002)
31 #define HKEY_USERS              ((HKEY) 0x80000003)
32 #define HKEY_PERFORMANCE_DATA   ((HKEY) 0x80000004)
33 #define HKEY_CURRENT_CONFIG     ((HKEY) 0x80000005)
34 #define HKEY_DYN_DATA           ((HKEY) 0x80000006)
35
36 /*
37  *      registry provider structs
38  */
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;
45
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;
52
53 typedef ACCESS_MASK REGSAM;
54 typedef LONG LSTATUS;
55
56 /*
57  * InitiateSystemShutdown() reasons
58  */
59 #include <reason.h>
60
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
65
66 #define MAX_SHUTDOWN_TIMEOUT    (10*365*24*60*60)
67
68 /*
69  * RegGetValue() restrictions
70  */
71
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)
84
85 BOOL        WINAPI AbortSystemShutdownA(LPSTR);
86 BOOL        WINAPI AbortSystemShutdownW(LPWSTR);
87 #define     AbortSystemShutdown WINELIB_NAME_AW(AbortSystemShutdown)
88 BOOL        WINAPI InitiateSystemShutdownA(LPSTR,LPSTR,DWORD,BOOL,BOOL);
89 BOOL        WINAPI InitiateSystemShutdownW(LPWSTR,LPWSTR,DWORD,BOOL,BOOL);
90 #define     InitiateSystemShutdown WINELIB_NAME_AW(InitiateSystemShutdown);
91 BOOL        WINAPI InitiateSystemShutdownExA(LPSTR,LPSTR,DWORD,BOOL,BOOL,DWORD);
92 BOOL        WINAPI InitiateSystemShutdownExW(LPWSTR,LPWSTR,DWORD,BOOL,BOOL,DWORD);
93 #define     InitiateSystemShutdownEx WINELIB_NAME_AW(InitiateSystemShutdownEx);
94 LSTATUS     WINAPI RegCreateKeyExA(HKEY,LPCSTR,DWORD,LPSTR,DWORD,REGSAM,
95                                      LPSECURITY_ATTRIBUTES,PHKEY,LPDWORD);
96 LSTATUS     WINAPI RegCreateKeyExW(HKEY,LPCWSTR,DWORD,LPWSTR,DWORD,REGSAM,
97                                      LPSECURITY_ATTRIBUTES,PHKEY,LPDWORD);
98 #define     RegCreateKeyEx WINELIB_NAME_AW(RegCreateKeyEx)
99 LSTATUS     WINAPI RegDisablePredefinedCache(void);
100 LSTATUS     WINAPI RegSaveKeyA(HKEY,LPCSTR,LPSECURITY_ATTRIBUTES);
101 LSTATUS     WINAPI RegSaveKeyW(HKEY,LPCWSTR,LPSECURITY_ATTRIBUTES);
102 #define     RegSaveKey WINELIB_NAME_AW(RegSaveKey)
103 LSTATUS     WINAPI RegSetKeySecurity(HKEY,SECURITY_INFORMATION,PSECURITY_DESCRIPTOR);
104 LSTATUS     WINAPI RegConnectRegistryA(LPCSTR,HKEY,PHKEY);
105 LSTATUS     WINAPI RegConnectRegistryW(LPCWSTR,HKEY,PHKEY);
106 #define     RegConnectRegistry WINELIB_NAME_AW(RegConnectRegistry)
107 LSTATUS     WINAPI RegEnumKeyExA(HKEY,DWORD,LPSTR,LPDWORD,LPDWORD,LPSTR,
108                                    LPDWORD,LPFILETIME);
109 LSTATUS     WINAPI RegEnumKeyExW(HKEY,DWORD,LPWSTR,LPDWORD,LPDWORD,LPWSTR,
110                                    LPDWORD,LPFILETIME);
111 #define     RegEnumKeyEx WINELIB_NAME_AW(RegEnumKeyEx)
112 LSTATUS     WINAPI RegGetKeySecurity(HKEY,SECURITY_INFORMATION,PSECURITY_DESCRIPTOR,LPDWORD);
113 LSTATUS     WINAPI RegGetValueA(HKEY,LPCSTR,LPCSTR,DWORD,LPDWORD,PVOID,LPDWORD);
114 LSTATUS     WINAPI RegGetValueW(HKEY,LPCWSTR,LPCWSTR,DWORD,LPDWORD,PVOID,LPDWORD);
115 #define     RegGetValue WINELIB_NAME_AW(RegGetValue)
116 LSTATUS     WINAPI RegLoadKeyA(HKEY,LPCSTR,LPCSTR);
117 LSTATUS     WINAPI RegLoadKeyW(HKEY,LPCWSTR,LPCWSTR);
118 #define     RegLoadKey WINELIB_NAME_AW(RegLoadKey)
119 LSTATUS     WINAPI RegLoadMUIStringA(HKEY,LPCSTR,LPSTR,DWORD,LPDWORD,DWORD,LPCSTR);
120 LSTATUS     WINAPI RegLoadMUIStringW(HKEY,LPCWSTR,LPWSTR,DWORD,LPDWORD,DWORD,LPCWSTR);
121 #define     RegLoadMUIString WINELIB_NAME_AW(RegLoadMUIString)
122 LSTATUS     WINAPI RegNotifyChangeKeyValue(HKEY,BOOL,DWORD,HANDLE,BOOL);
123 LSTATUS     WINAPI RegOpenCurrentUser(REGSAM,PHKEY);
124 LSTATUS     WINAPI RegOpenKeyExW(HKEY,LPCWSTR,DWORD,REGSAM,PHKEY);
125 LSTATUS     WINAPI RegOpenKeyExA(HKEY,LPCSTR,DWORD,REGSAM,PHKEY);
126 #define     RegOpenKeyEx WINELIB_NAME_AW(RegOpenKeyEx)
127 LSTATUS     WINAPI RegOpenUserClassesRoot(HANDLE,DWORD,REGSAM,PHKEY);
128 LSTATUS     WINAPI RegQueryInfoKeyW(HKEY,LPWSTR,LPDWORD,LPDWORD,LPDWORD,
129                                       LPDWORD,LPDWORD,LPDWORD,LPDWORD,LPDWORD,
130                                       LPDWORD,LPFILETIME);
131 LSTATUS     WINAPI RegQueryInfoKeyA(HKEY,LPSTR,LPDWORD,LPDWORD,LPDWORD,
132                                       LPDWORD,LPDWORD,LPDWORD,LPDWORD,LPDWORD,
133                                       LPDWORD,LPFILETIME);
134 #define     RegQueryInfoKey WINELIB_NAME_AW(RegQueryInfoKey)
135 LSTATUS     WINAPI RegQueryMultipleValuesA(HKEY,PVALENTA,DWORD,LPSTR,LPDWORD);
136 LSTATUS     WINAPI RegQueryMultipleValuesW(HKEY,PVALENTW,DWORD,LPWSTR,LPDWORD);
137 #define     RegQueryMultipleValues WINELIB_NAME_AW(RegQueryMultipleValues)
138 LSTATUS     WINAPI RegReplaceKeyA(HKEY,LPCSTR,LPCSTR,LPCSTR);
139 LSTATUS     WINAPI RegReplaceKeyW(HKEY,LPCWSTR,LPCWSTR,LPCWSTR);
140 #define     RegReplaceKey WINELIB_NAME_AW(RegReplaceKey)
141 LSTATUS     WINAPI RegRestoreKeyA(HKEY,LPCSTR,DWORD);
142 LSTATUS     WINAPI RegRestoreKeyW(HKEY,LPCWSTR,DWORD);
143 #define     RegRestoreKey WINELIB_NAME_AW(RegRestoreKey)
144 LSTATUS     WINAPI RegUnLoadKeyA(HKEY,LPCSTR);
145 LSTATUS     WINAPI RegUnLoadKeyW(HKEY,LPCWSTR);
146 #define     RegUnLoadKey WINELIB_NAME_AW(RegUnLoadKey)
147
148 /* Declarations for functions that are the same in Win16 and Win32 */
149
150 LSTATUS     WINAPI RegCloseKey(HKEY);
151 LSTATUS     WINAPI RegFlushKey(HKEY);
152
153 LSTATUS     WINAPI RegCreateKeyA(HKEY,LPCSTR,PHKEY);
154 LSTATUS     WINAPI RegCreateKeyW(HKEY,LPCWSTR,PHKEY);
155 #define     RegCreateKey WINELIB_NAME_AW(RegCreateKey)
156 LSTATUS     WINAPI RegDeleteKeyA(HKEY,LPCSTR);
157 LSTATUS     WINAPI RegDeleteKeyW(HKEY,LPCWSTR);
158 #define     RegDeleteKey WINELIB_NAME_AW(RegDeleteKey)
159 LSTATUS     WINAPI RegDeleteKeyValueA(HKEY,LPCSTR,LPCSTR);
160 LSTATUS     WINAPI RegDeleteKeyValueW(HKEY,LPCWSTR,LPCWSTR);
161 #define     RegDeleteKeyValue WINELIB_NAME_AW(RegDeleteKeyValue)
162 LSTATUS     WINAPI RegDeleteTreeA(HKEY,LPCSTR);
163 LSTATUS     WINAPI RegDeleteTreeW(HKEY,LPCWSTR);
164 #define     RegDeleteTree WINELIB_NAME_AW(RegDeleteTree)
165 LSTATUS     WINAPI RegDeleteValueA(HKEY,LPCSTR);
166 LSTATUS     WINAPI RegDeleteValueW(HKEY,LPCWSTR);
167 #define     RegDeleteValue WINELIB_NAME_AW(RegDeleteValue)
168 LSTATUS     WINAPI RegEnumKeyA(HKEY,DWORD,LPSTR,DWORD);
169 LSTATUS     WINAPI RegEnumKeyW(HKEY,DWORD,LPWSTR,DWORD);
170 #define     RegEnumKey WINELIB_NAME_AW(RegEnumKey)
171 LSTATUS     WINAPI RegEnumValueA(HKEY,DWORD,LPSTR,LPDWORD,LPDWORD,LPDWORD,LPBYTE,LPDWORD);
172 LSTATUS     WINAPI RegEnumValueW(HKEY,DWORD,LPWSTR,LPDWORD,LPDWORD,LPDWORD,LPBYTE,LPDWORD);
173 #define     RegEnumValue WINELIB_NAME_AW(RegEnumValue)
174 LSTATUS     WINAPI RegOpenKeyA(HKEY,LPCSTR,PHKEY);
175 LSTATUS     WINAPI RegOpenKeyW(HKEY,LPCWSTR,PHKEY);
176 #define     RegOpenKey WINELIB_NAME_AW(RegOpenKey)
177 LSTATUS     WINAPI RegQueryValueA(HKEY,LPCSTR,LPSTR,LPLONG);
178 LSTATUS     WINAPI RegQueryValueW(HKEY,LPCWSTR,LPWSTR,LPLONG);
179 #define     RegQueryValue WINELIB_NAME_AW(RegQueryValue)
180 LSTATUS     WINAPI RegQueryValueExA(HKEY,LPCSTR,LPDWORD,LPDWORD,LPBYTE,LPDWORD);
181 LSTATUS     WINAPI RegQueryValueExW(HKEY,LPCWSTR,LPDWORD,LPDWORD,LPBYTE,LPDWORD);
182 #define     RegQueryValueEx WINELIB_NAME_AW(RegQueryValueEx)
183 LSTATUS     WINAPI RegSetValueA(HKEY,LPCSTR,DWORD,LPCSTR,DWORD);
184 LSTATUS     WINAPI RegSetValueW(HKEY,LPCWSTR,DWORD,LPCWSTR,DWORD);
185 #define     RegSetValue WINELIB_NAME_AW(RegSetValue)
186 LSTATUS     WINAPI RegSetValueExA(HKEY,LPCSTR,DWORD,DWORD,CONST BYTE*,DWORD);
187 LSTATUS     WINAPI RegSetValueExW(HKEY,LPCWSTR,DWORD,DWORD,CONST BYTE*,DWORD);
188 #define     RegSetValueEx WINELIB_NAME_AW(RegSetValueEx)
189
190 #ifdef __cplusplus
191 } /* extern "C" */
192 #endif /* defined(__cplusplus) */
193
194 #endif  /* __WINE_WINREG_H */