Added unit tests for RegGetValue.
[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., 59 Temple Place, Suite 330, Boston, MA  02111-1307  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
55 /*
56  * InitiateSystemShutdown() reasons
57  */
58 #include <reason.h>
59
60 #define REASON_OTHER            (SHTDN_REASON_MAJOR_OTHER | SHTDN_REASON_MINOR_OTHER)
61 #define REASON_UNKNOWN          SHTDN_REASON_UNKNOWN
62 #define REASON_LEGACY_API       SHTDN_REASON_LEGACY_API
63 #define REASON_PLANNED_FLAG     SHTDN_REASON_FLAG_PLANNED
64
65 #define MAX_SHUTDOWN_TIMEOUT    (10*365*24*60*60)
66
67 /*
68  * RegGetValue() restrictions
69  */
70
71 #define RRF_RT_REG_NONE         (1 << 0)
72 #define RRF_RT_REG_SZ           (1 << 1)
73 #define RRF_RT_REG_EXPAND_SZ    (1 << 2)
74 #define RRF_RT_REG_BINARY       (1 << 3)
75 #define RRF_RT_REG_DWORD        (1 << 4)
76 #define RRF_RT_REG_MULTI_SZ     (1 << 5)
77 #define RRF_RT_REG_QWORD        (1 << 6)
78 #define RRF_RT_DWORD            (RRF_RT_REG_BINARY | RRF_RT_REG_DWORD)
79 #define RRF_RT_QWORD            (RRF_RT_REG_BINARY | RRF_RT_REG_QWORD)
80 #define RRF_NOEXPAND            (1 << 28)
81 #define RRF_ZEROONFAILURE       (1 << 29)
82
83 BOOL        WINAPI AbortSystemShutdownA(LPSTR);
84 BOOL        WINAPI AbortSystemShutdownW(LPWSTR);
85 #define     AbortSystemShutdown WINELIB_NAME_AW(AbortSystemShutdown)
86 BOOL        WINAPI InitiateSystemShutdownA(LPSTR,LPSTR,DWORD,BOOL,BOOL);
87 BOOL        WINAPI InitiateSystemShutdownW(LPWSTR,LPWSTR,DWORD,BOOL,BOOL);
88 #define     InitiateSystemShutdown WINELIB_NAME_AW(InitiateSystemShutdown);
89 BOOL        WINAPI InitiateSystemShutdownExA(LPSTR,LPSTR,DWORD,BOOL,BOOL,DWORD);
90 BOOL        WINAPI InitiateSystemShutdownExW(LPWSTR,LPWSTR,DWORD,BOOL,BOOL,DWORD);
91 #define     InitiateSystemShutdownEx WINELIB_NAME_AW(InitiateSystemShutdownEx);
92 DWORD       WINAPI RegCreateKeyExA(HKEY,LPCSTR,DWORD,LPCSTR,DWORD,REGSAM,
93                                      LPSECURITY_ATTRIBUTES,PHKEY,LPDWORD);
94 DWORD       WINAPI RegCreateKeyExW(HKEY,LPCWSTR,DWORD,LPCWSTR,DWORD,REGSAM,
95                                      LPSECURITY_ATTRIBUTES,PHKEY,LPDWORD);
96 #define     RegCreateKeyEx WINELIB_NAME_AW(RegCreateKeyEx)
97 LONG        WINAPI RegSaveKeyA(HKEY,LPCSTR,LPSECURITY_ATTRIBUTES);
98 LONG        WINAPI RegSaveKeyW(HKEY,LPCWSTR,LPSECURITY_ATTRIBUTES);
99 #define     RegSaveKey WINELIB_NAME_AW(RegSaveKey)
100 LONG        WINAPI RegSetKeySecurity(HKEY,SECURITY_INFORMATION,PSECURITY_DESCRIPTOR);
101 LONG        WINAPI RegConnectRegistryA(LPCSTR,HKEY,PHKEY);
102 LONG        WINAPI RegConnectRegistryW(LPCWSTR,HKEY,PHKEY);
103 #define     RegConnectRegistry WINELIB_NAME_AW(RegConnectRegistry)
104 DWORD       WINAPI RegEnumKeyExA(HKEY,DWORD,LPSTR,LPDWORD,LPDWORD,LPSTR,
105                                    LPDWORD,LPFILETIME);
106 DWORD       WINAPI RegEnumKeyExW(HKEY,DWORD,LPWSTR,LPDWORD,LPDWORD,LPWSTR,
107                                    LPDWORD,LPFILETIME);
108 #define     RegEnumKeyEx WINELIB_NAME_AW(RegEnumKeyEx)
109 LONG        WINAPI RegGetKeySecurity(HKEY,SECURITY_INFORMATION,PSECURITY_DESCRIPTOR,LPDWORD);
110 LONG        WINAPI RegLoadKeyA(HKEY,LPCSTR,LPCSTR);
111 LONG        WINAPI RegLoadKeyW(HKEY,LPCWSTR,LPCWSTR);
112 #define     RegLoadKey WINELIB_NAME_AW(RegLoadKey)
113 LONG        WINAPI RegNotifyChangeKeyValue(HKEY,BOOL,DWORD,HANDLE,BOOL);
114 DWORD       WINAPI RegOpenCurrentUser(REGSAM,PHKEY);
115 DWORD       WINAPI RegOpenKeyExW(HKEY,LPCWSTR,DWORD,REGSAM,PHKEY);
116 DWORD       WINAPI RegOpenKeyExA(HKEY,LPCSTR,DWORD,REGSAM,PHKEY);
117 #define     RegOpenKeyEx WINELIB_NAME_AW(RegOpenKeyEx)
118 LONG        WINAPI RegOpenUserClassesRoot(HANDLE,DWORD,REGSAM,PHKEY);
119 DWORD       WINAPI RegQueryInfoKeyW(HKEY,LPWSTR,LPDWORD,LPDWORD,LPDWORD,
120                                       LPDWORD,LPDWORD,LPDWORD,LPDWORD,LPDWORD,
121                                       LPDWORD,LPFILETIME);
122 DWORD       WINAPI RegQueryInfoKeyA(HKEY,LPSTR,LPDWORD,LPDWORD,LPDWORD,
123                                       LPDWORD,LPDWORD,LPDWORD,LPDWORD,LPDWORD,
124                                       LPDWORD,LPFILETIME);
125 #define     RegQueryInfoKey WINELIB_NAME_AW(RegQueryInfoKey)
126 DWORD       WINAPI RegQueryMultipleValuesA(HKEY,PVALENTA,DWORD,LPSTR,LPDWORD);
127 DWORD       WINAPI RegQueryMultipleValuesW(HKEY,PVALENTW,DWORD,LPWSTR,LPDWORD);
128 #define     RegQueryMultipleValues WINELIB_NAME_AW(RegQueryMultipleValues)
129 LONG        WINAPI RegReplaceKeyA(HKEY,LPCSTR,LPCSTR,LPCSTR);
130 LONG        WINAPI RegReplaceKeyW(HKEY,LPCWSTR,LPCWSTR,LPCWSTR);
131 #define     RegReplaceKey WINELIB_NAME_AW(RegReplaceKey)
132 LONG        WINAPI RegRestoreKeyA(HKEY,LPCSTR,DWORD);
133 LONG        WINAPI RegRestoreKeyW(HKEY,LPCWSTR,DWORD);
134 #define     RegRestoreKey WINELIB_NAME_AW(RegRestoreKey)
135 LONG        WINAPI RegUnLoadKeyA(HKEY,LPCSTR);
136 LONG        WINAPI RegUnLoadKeyW(HKEY,LPCWSTR);
137 #define     RegUnLoadKey WINELIB_NAME_AW(RegUnLoadKey)
138
139 /* Declarations for functions that are the same in Win16 and Win32 */
140
141 DWORD       WINAPI RegCloseKey(HKEY);
142 DWORD       WINAPI RegFlushKey(HKEY);
143
144 DWORD       WINAPI RegCreateKeyA(HKEY,LPCSTR,PHKEY);
145 DWORD       WINAPI RegCreateKeyW(HKEY,LPCWSTR,PHKEY);
146 #define     RegCreateKey WINELIB_NAME_AW(RegCreateKey)
147 DWORD       WINAPI RegDeleteKeyA(HKEY,LPCSTR);
148 DWORD       WINAPI RegDeleteKeyW(HKEY,LPCWSTR);
149 #define     RegDeleteKey WINELIB_NAME_AW(RegDeleteKey)
150 DWORD       WINAPI RegDeleteValueA(HKEY,LPCSTR);
151 DWORD       WINAPI RegDeleteValueW(HKEY,LPCWSTR);
152 #define     RegDeleteValue WINELIB_NAME_AW(RegDeleteValue)
153 DWORD       WINAPI RegEnumKeyA(HKEY,DWORD,LPSTR,DWORD);
154 DWORD       WINAPI RegEnumKeyW(HKEY,DWORD,LPWSTR,DWORD);
155 #define     RegEnumKey WINELIB_NAME_AW(RegEnumKey)
156 DWORD       WINAPI RegEnumValueA(HKEY,DWORD,LPSTR,LPDWORD,LPDWORD,LPDWORD,LPBYTE,LPDWORD);
157 DWORD       WINAPI RegEnumValueW(HKEY,DWORD,LPWSTR,LPDWORD,LPDWORD,LPDWORD,LPBYTE,LPDWORD);
158 #define     RegEnumValue WINELIB_NAME_AW(RegEnumValue)
159 DWORD       WINAPI RegOpenKeyA(HKEY,LPCSTR,PHKEY);
160 DWORD       WINAPI RegOpenKeyW(HKEY,LPCWSTR,PHKEY);
161 #define     RegOpenKey WINELIB_NAME_AW(RegOpenKey)
162 DWORD       WINAPI RegQueryValueA(HKEY,LPCSTR,LPSTR,LPLONG);
163 DWORD       WINAPI RegQueryValueW(HKEY,LPCWSTR,LPWSTR,LPLONG);
164 #define     RegQueryValue WINELIB_NAME_AW(RegQueryValue)
165 DWORD       WINAPI RegQueryValueExA(HKEY,LPCSTR,LPDWORD,LPDWORD,LPBYTE,LPDWORD);
166 DWORD       WINAPI RegQueryValueExW(HKEY,LPCWSTR,LPDWORD,LPDWORD,LPBYTE,LPDWORD);
167 #define     RegQueryValueEx WINELIB_NAME_AW(RegQueryValueEx)
168 DWORD       WINAPI RegSetValueA(HKEY,LPCSTR,DWORD,LPCSTR,DWORD);
169 DWORD       WINAPI RegSetValueW(HKEY,LPCWSTR,DWORD,LPCWSTR,DWORD);
170 #define     RegSetValue WINELIB_NAME_AW(RegSetValue)
171 DWORD       WINAPI RegSetValueExA(HKEY,LPCSTR,DWORD,DWORD,CONST BYTE*,DWORD);
172 DWORD       WINAPI RegSetValueExW(HKEY,LPCWSTR,DWORD,DWORD,CONST BYTE*,DWORD);
173 #define     RegSetValueEx WINELIB_NAME_AW(RegSetValueEx)
174
175 #ifdef __cplusplus
176 } /* extern "C" */
177 #endif /* defined(__cplusplus) */
178
179 #endif  /* __WINE_WINREG_H */