source/include/reg_objects.h

   1 /*
   2    Samba's Internal Registry objects
   3
   4    SMB parameters and setup
   5    Copyright (C) Gerald Carter                   2002-2006.
   6
   7    This program is free software; you can redistribute it and/or modify
   8    it under the terms of the GNU General Public License as published by
   9    the Free Software Foundation; either version 2 of the License, or
  10    (at your option) any later version.
  11
  12    This program is distributed in the hope that it will be useful,
  13    but WITHOUT ANY WARRANTY; without even the implied warranty of
  14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15    GNU General Public License for more details.
  16
  17    You should have received a copy of the GNU General Public License
  18    along with this program; if not, write to the Free Software
  19    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  20 */
  21
  22 #ifndef _REG_OBJECTS_H /* _REG_OBJECTS_H */
  23 #define _REG_OBJECTS_H
  24
  25 /* structure to contain registry values */
  26
  27 typedef struct {
  28         fstring         valuename;
  29         uint16          type;
  30         /* this should be encapsulated in an RPC_DATA_BLOB */
  31         uint32          size;   /* in bytes */
  32         uint8           *data_p;
  33 } REGISTRY_VALUE;
  34
  35 /*
  36  * A REG_SZ string is not necessarily NULL terminated. When retrieving it from
  37  * the net, we guarantee this however. A server might want to push it without
  38  * the terminator though.
  39  */
  40
  41 struct registry_string {
  42         size_t len;
  43         char *str;
  44 };
  45
  46 struct registry_value {
  47         enum winreg_Type type;
  48         union {
  49                 uint32 dword;
  50                 uint64 qword;
  51                 struct registry_string sz;
  52                 struct {
  53                         uint32 num_strings;
  54                         char **strings;
  55                 } multi_sz;
  56                 DATA_BLOB binary;
  57         } v;
  58 };
  59
  60 /* container for registry values */
  61
  62 typedef struct {
  63         uint32          num_values;
  64         REGISTRY_VALUE  **values;
  65 } REGVAL_CTR;
  66
  67 /* container for registry subkey names */
  68
  69 typedef struct {
  70         uint32          num_subkeys;
  71         char            **subkeys;
  72 } REGSUBKEY_CTR;
  73
  74 /*
  75  *
  76  * Macros that used to reside in rpc_reg.h
  77  *
  78  */
  79
  80 #define HKEY_CLASSES_ROOT       0x80000000
  81 #define HKEY_CURRENT_USER       0x80000001
  82 #define HKEY_LOCAL_MACHINE      0x80000002
  83 #define HKEY_USERS              0x80000003
  84 #define HKEY_PERFORMANCE_DATA   0x80000004
  85
  86 #define KEY_HKLM                "HKLM"
  87 #define KEY_HKU                 "HKU"
  88 #define KEY_HKCC                "HKCC"
  89 #define KEY_HKCR                "HKCR"
  90 #define KEY_HKPD                "HKPD"
  91 #define KEY_HKPT                "HKPT"
  92 #define KEY_HKPN                "HKPN"
  93 #define KEY_HKCU                "HKCU"
  94 #define KEY_HKDD                "HKDD"
  95 #define KEY_SERVICES            "HKLM\\SYSTEM\\CurrentControlSet\\Services"
  96 #define KEY_PRINTING            "HKLM\\SYSTEM\\CurrentControlSet\\Control\\Print"
  97 #define KEY_PRINTING_2K         "HKLM\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\Print\\Printers"
  98 #define KEY_PRINTING_PORTS      "HKLM\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\Ports"
  99 #define KEY_EVENTLOG            "HKLM\\SYSTEM\\CurrentControlSet\\Services\\Eventlog"
 100 #define KEY_SHARES              "HKLM\\SYSTEM\\CurrentControlSet\\Services\\LanmanServer\\Shares"
 101 #define KEY_TREE_ROOT           ""
 102
 103 /*
 104  * Registry key types
 105  *      Most keys are going to be GENERIC -- may need a better name?
 106  *      HKPD and HKPT are used by reg_perfcount.c
 107  *              they are special keys that contain performance data
 108  */
 109 #define REG_KEY_GENERIC         0
 110 #define REG_KEY_HKPD            1
 111 #define REG_KEY_HKPT            2
 112
 113 /*
 114  * container for function pointers to enumeration routines
 115  * for virtual registry view
 116  */
 117
 118 typedef struct {
 119         /* functions for enumerating subkeys and values */
 120         int     (*fetch_subkeys)( const char *key, REGSUBKEY_CTR *subkeys);
 121         int     (*fetch_values) ( const char *key, REGVAL_CTR *val );
 122         BOOL    (*store_subkeys)( const char *key, REGSUBKEY_CTR *subkeys );
 123         BOOL    (*store_values)( const char *key, REGVAL_CTR *val );
 124         BOOL    (*reg_access_check)( const char *keyname, uint32 requested, uint32 *granted, NT_USER_TOKEN *token );
 125 } REGISTRY_OPS;
 126
 127 typedef struct {
 128         const char      *keyname;       /* full path to name of key */
 129         REGISTRY_OPS    *ops;           /* registry function hooks */
 130 } REGISTRY_HOOK;
 131
 132
 133 /* structure to store the registry handles */
 134
 135 typedef struct _RegistryKey {
 136         uint32          type;
 137         char            *name;          /* full name of registry key */
 138         uint32          access_granted;
 139         REGISTRY_HOOK   *hook;
 140 } REGISTRY_KEY;
 141
 142 #endif /* _REG_OBJECTS_H */
 143