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 */