libgpo/gpext/gpext.h

   1 /*
   2  *  Unix SMB/CIFS implementation.
   3  *  Group Policy Support
   4  *  Copyright (C) Guenther Deschner 2007-2008
   5  *
   6  *  This program is free software; you can redistribute it and/or modify
   7  *  it under the terms of the GNU General Public License as published by
   8  *  the Free Software Foundation; either version 3 of the License, or
   9  *  (at your option) any later version.
  10  *
  11  *  This program 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
  14  *  GNU General Public License for more details.
  15  *
  16  *  You should have received a copy of the GNU General Public License
  17  *  along with this program; if not, see <http://www.gnu.org/licenses/>.
  18  */
  19
  20 #ifndef __GPEXT_H__
  21 #define __GPEXT_H__
  22
  23 #include "librpc/gen_ndr/winreg.h"
  24
  25 #define KEY_WINLOGON_GPEXT_PATH "HKLM\\Software\\Microsoft\\Windows NT\\CurrentVersion\\Winlogon\\GPExtensions"
  26
  27 #define SAMBA_SUBSYSTEM_GPEXT "gpext"
  28
  29 #define SMB_GPEXT_INTERFACE_VERSION 1
  30
  31 struct gp_extension {
  32         struct GUID *guid;
  33         const char *name;
  34         struct gp_extension_methods *methods;
  35         struct gp_extension *prev, *next;
  36 };
  37
  38 struct gp_extension_reg_table {
  39         const char *val;
  40         enum winreg_Type type;
  41         const char *data;
  42 };
  43
  44 struct gp_extension_reg_entry {
  45         const char *value;
  46         struct registry_value *data;
  47 };
  48
  49 struct gp_extension_reg_info_entry {
  50         struct GUID guid;
  51         size_t num_entries;
  52         struct gp_extension_reg_entry *entries;
  53 };
  54
  55 struct gp_extension_reg_info {
  56         size_t num_entries;
  57         struct gp_extension_reg_info_entry *entries;
  58 };
  59
  60 struct gp_extension_methods {
  61
  62         NTSTATUS (*initialize)(TALLOC_CTX *mem_ctx);
  63
  64         NTSTATUS (*process_group_policy)(ADS_STRUCT *ads,
  65                                          TALLOC_CTX *mem_ctx,
  66                                          uint32_t flags,
  67                                          struct registry_key *root_key,
  68                                          const struct security_token *token,
  69                                          struct GROUP_POLICY_OBJECT *gpo,
  70                                          const char *extension_guid,
  71                                          const char *snapin_guid);
  72
  73         NTSTATUS (*process_group_policy2)(ADS_STRUCT *ads,
  74                                          TALLOC_CTX *mem_ctx,
  75                                          uint32_t flags,
  76                                          const struct security_token *token,
  77                                          struct GROUP_POLICY_OBJECT *gpo_list,
  78                                          const char *extension_guid);
  79
  80         NTSTATUS (*get_reg_config)(TALLOC_CTX *mem_ctx,
  81                                    struct gp_extension_reg_info **info);
  82
  83         NTSTATUS (*shutdown)(void);
  84 };
  85
  86 /* The following definitions come from libgpo/gpext/gpext.c  */
  87
  88 struct gp_extension *get_gp_extension_list(void);
  89 NTSTATUS unregister_gp_extension(const char *name);
  90 NTSTATUS register_gp_extension(TALLOC_CTX *gpext_ctx,
  91                                int version,
  92                                const char *name,
  93                                const char *guid,
  94                                struct gp_extension_methods *methods);
  95 NTSTATUS gp_ext_info_add_entry(TALLOC_CTX *mem_ctx,
  96                                const char *module,
  97                                const char *ext_guid,
  98                                struct gp_extension_reg_table *table,
  99                                struct gp_extension_reg_info *info);
 100 NTSTATUS shutdown_gp_extensions(void);
 101 NTSTATUS init_gp_extensions(TALLOC_CTX *mem_ctx);
 102 NTSTATUS free_gp_extensions(void);
 103 void debug_gpext_header(int lvl,
 104                         const char *name,
 105                         uint32_t flags,
 106                         struct GROUP_POLICY_OBJECT *gpo,
 107                         const char *extension_guid,
 108                         const char *snapin_guid);
 109 NTSTATUS process_gpo_list_with_extension(ADS_STRUCT *ads,
 110                            TALLOC_CTX *mem_ctx,
 111                            uint32_t flags,
 112                            const struct security_token *token,
 113                            struct GROUP_POLICY_OBJECT *gpo_list,
 114                            const char *extension_guid,
 115                            const char *snapin_guid);
 116 NTSTATUS gpext_process_extension(ADS_STRUCT *ads,
 117                                  TALLOC_CTX *mem_ctx,
 118                                  uint32_t flags,
 119                                  const struct security_token *token,
 120                                  struct registry_key *root_key,
 121                                  struct GROUP_POLICY_OBJECT *gpo,
 122                                  const char *extension_guid,
 123                                  const char *snapin_guid);
 124
 125
 126 #endif /* __GPEXT_H__ */