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)(TALLOC_CTX *mem_ctx,
  65                                          uint32_t flags,
  66                                          struct registry_key *root_key,
  67                                          const struct security_token *token,
  68                                          const struct GROUP_POLICY_OBJECT *deleted_gpo_list,
  69                                          const struct GROUP_POLICY_OBJECT *changed_gpo_list);
  70
  71         NTSTATUS (*get_reg_config)(TALLOC_CTX *mem_ctx,
  72                                    struct gp_extension_reg_info **info);
  73
  74         NTSTATUS (*shutdown)(void);
  75 };
  76
  77 /* The following definitions come from libgpo/gpext/gpext.c  */
  78
  79 struct gp_extension *gpext_get_gp_extension_list(void);
  80 NTSTATUS gpext_unregister_gp_extension(const char *name);
  81 NTSTATUS gpext_register_gp_extension(TALLOC_CTX *gpext_ctx,
  82                                      int version,
  83                                      const char *name,
  84                                      const char *guid,
  85                                      struct gp_extension_methods *methods);
  86 NTSTATUS gpext_info_add_entry(TALLOC_CTX *mem_ctx,
  87                               const char *module,
  88                               const char *ext_guid,
  89                               struct gp_extension_reg_table *table,
  90                               struct gp_extension_reg_info *info);
  91 NTSTATUS gpext_shutdown_gp_extensions(void);
  92 NTSTATUS gpext_init_gp_extensions(TALLOC_CTX *mem_ctx);
  93 NTSTATUS gpext_free_gp_extensions(void);
  94 void gpext_debug_header(int lvl,
  95                         const char *name,
  96                         uint32_t flags,
  97                         const struct GROUP_POLICY_OBJECT *gpo,
  98                         const char *extension_guid,
  99                         const char *snapin_guid);
 100 NTSTATUS gpext_process_extension(TALLOC_CTX *mem_ctx,
 101                                  uint32_t flags,
 102                                  const struct security_token *token,
 103                                  struct registry_key *root_key,
 104                                  const struct GROUP_POLICY_OBJECT *deleted_gpo_list,
 105                                  const struct GROUP_POLICY_OBJECT *changed_gpo_list,
 106                                  const char *extension_guid);
 107
 108
 109 #endif /* __GPEXT_H__ */