include/objsel.h

   1 /*
   2  * objsel.h
   3  *
   4  * Object Picker Dialog
   5  *
   6  * THIS SOFTWARE IS NOT COPYRIGHTED
   7  *
   8  * This source code is offered for use in the public domain. You may
   9  * use, modify or distribute it freely.
  10  *
  11  * This code is distributed in the hope that it will be useful but
  12  * WITHOUT ANY WARRANTY. ALL WARRANTIES, EXPRESS OR IMPLIED ARE HEREBY
  13  * DISCLAIMED. This includes but is not limited to warranties of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  15  *
  16  */
  17 #ifndef __OBJSEL_H_
  18 #define __OBJSEL_H_
  19
  20 #ifdef __cplusplus
  21 extern "C" {
  22 #endif
  23
  24 DEFINE_GUID(CLSID_DsObjectPicker, 0x17d6ccd8, 0x3b7b, 0x11d2, 0xb9,0xe0,0x00,0xc0,0x4f,0xd8,0xdb,0xf7);
  25 DEFINE_GUID(IID_IDsObjectPicker,  0x0c87e64e, 0x3b7a, 0x11d2, 0xb9,0xe0,0x00,0xc0,0x4f,0xd8,0xdb,0xf7);
  26
  27 #define CFSTR_DSOP_DS_SELECTION_LIST    TEXT("CFSTR_DSOP_DS_SELECTION_LIST")
  28
  29 /* up-level scope filters in the DSOP_UPLEVEL_FILTER_FLAGS structure */
  30 #define DSOP_FILTER_INCLUDE_ADVANCED_VIEW       (0x1)
  31 #define DSOP_FILTER_USERS       (0x2)
  32 #define DSOP_FILTER_BUILTIN_GROUPS      (0x4)
  33 #define DSOP_FILTER_WELL_KNOWN_PRINCIPALS       (0x8)
  34 #define DSOP_FILTER_UNIVERSAL_GROUPS_DL (0x10)
  35 #define DSOP_FILTER_UNIVERSAL_GROUPS_SE (0x20)
  36 #define DSOP_FILTER_GLOBAL_GROUPS_DL    (0x40)
  37 #define DSOP_FILTER_GLOBAL_GROUPS_SE    (0x80)
  38 #define DSOP_FILTER_DOMAIN_LOCAL_GROUPS_DL      (0x100)
  39 #define DSOP_FILTER_DOMAIN_LOCAL_GROUPS_SE      (0x200)
  40 #define DSOP_FILTER_CONTACTS    (0x400)
  41 #define DSOP_FILTER_COMPUTERS   (0x800)
  42
  43 typedef struct _DSOP_UPLEVEL_FILTER_FLAGS
  44 {
  45     ULONG flBothModes;
  46     ULONG flMixedModeOnly;
  47     ULONG flNativeModeOnly;
  48 } DSOP_UPLEVEL_FILTER_FLAGS, *PDSOP_UPLEVEL_FILTER_FLAGS;
  49
  50 /* down-level scope filters in the DSOP_FILTER_FLAGS structure */
  51 #define DSOP_DOWNLEVEL_FILTER_USERS     (0x80000001)
  52 #define DSOP_DOWNLEVEL_FILTER_LOCAL_GROUPS      (0x80000002)
  53 #define DSOP_DOWNLEVEL_FILTER_GLOBAL_GROUPS     (0x80000004)
  54 #define DSOP_DOWNLEVEL_FILTER_COMPUTERS (0x80000008)
  55 #define DSOP_DOWNLEVEL_FILTER_WORLD     (0x80000010)
  56 #define DSOP_DOWNLEVEL_FILTER_AUTHENTICATED_USER        (0x80000020)
  57 #define DSOP_DOWNLEVEL_FILTER_ANONYMOUS (0x80000040)
  58 #define DSOP_DOWNLEVEL_FILTER_BATCH     (0x80000080)
  59 #define DSOP_DOWNLEVEL_FILTER_CREATOR_OWNER     (0x80000100)
  60 #define DSOP_DOWNLEVEL_FILTER_CREATOR_GROUP     (0x80000200)
  61 #define DSOP_DOWNLEVEL_FILTER_DIALUP    (0x80000400)
  62 #define DSOP_DOWNLEVEL_FILTER_INTERACTIVE       (0x80000800)
  63 #define DSOP_DOWNLEVEL_FILTER_NETWORK   (0x80001000)
  64 #define DSOP_DOWNLEVEL_FILTER_SERVICE   (0x80002000)
  65 #define DSOP_DOWNLEVEL_FILTER_SYSTEM    (0x80004000)
  66 #define DSOP_DOWNLEVEL_FILTER_EXCLUDE_BUILTIN_GROUPS    (0x80008000)
  67 #define DSOP_DOWNLEVEL_FILTER_TERMINAL_SERVER   (0x80010000)
  68 #define DSOP_DOWNLEVEL_FILTER_ALL_WELLKNOWN_SIDS        (0x80020000)
  69 #define DSOP_DOWNLEVEL_FILTER_LOCAL_SERVICE     (0x80040000)
  70 #define DSOP_DOWNLEVEL_FILTER_NETWORK_SERVICE   (0x80080000)
  71 #define DSOP_DOWNLEVEL_FILTER_REMOTE_LOGON      (0x80100000)
  72
  73 typedef struct _DSOP_FILTER_FLAGS
  74 {
  75     DSOP_UPLEVEL_FILTER_FLAGS Uplevel;
  76     ULONG flDownlevel;
  77 } DSOP_FILTER_FLAGS, *PDSOP_FILTER_FLAGS;
  78
  79 /* ADsPath format flags in the DSOP_SCOPE_INIT_INFO structure */
  80 #define DSOP_SCOPE_FLAG_STARTING_SCOPE  (0x1)
  81 #define DSOP_SCOPE_FLAG_WANT_PROVIDER_WINNT     (0x2)
  82 #define DSOP_SCOPE_FLAG_WANT_PROVIDER_LDAP      (0x4)
  83 #define DSOP_SCOPE_FLAG_WANT_PROVIDER_GC        (0x8)
  84 #define DSOP_SCOPE_FLAG_WANT_SID_PATH   (0x10)
  85 #define DSOP_SCOPE_FLAG_WANT_DOWNLEVEL_BUILTIN_PATH     (0x20)
  86 #define DSOP_SCOPE_FLAG_DEFAULT_FILTER_USERS    (0x40)
  87 #define DSOP_SCOPE_FLAG_DEFAULT_FILTER_GROUPS   (0x80)
  88 #define DSOP_SCOPE_FLAG_DEFAULT_FILTER_COMPUTERS        (0x100)
  89 #define DSOP_SCOPE_FLAG_DEFAULT_FILTER_CONTACTS (0x200)
  90
  91 typedef struct _DSOP_SCOPE_INIT_INFO
  92 {
  93     ULONG cbSize;
  94     ULONG flType;
  95     ULONG flScope;
  96     DSOP_FILTER_FLAGS FilterFlags;
  97     PCWSTR pwzDcName;
  98     PCWSTR pwzADsPath;
  99     HRESULT hr;
 100 } DSOP_SCOPE_INIT_INFO, *PDSOP_SCOPE_INIT_INFO;
 101 typedef const DSOP_SCOPE_INIT_INFO *PCDSOP_SCOPE_INIT_INFO;
 102
 103 /* object picker options in the DSOP_INIT_INFO structure */
 104 #define DSOP_FLAG_MULTISELECT   (0x1)
 105 #define DSOP_FLAG_SKIP_TARGET_COMPUTER_DC_CHECK (0x2)
 106
 107 typedef struct _DSOP_INIT_INFO
 108 {
 109     ULONG cbSize;
 110     PCWSTR pwzTargetComputer;
 111     ULONG cDsScopeInfos;
 112     PDSOP_SCOPE_INIT_INFO aDsScopeInfos;
 113     ULONG flOptions;
 114     ULONG cAttributesToFetch;
 115     PCWSTR *apwzAttributeNames;
 116 } DSOP_INIT_INFO, *PDSOP_INIT_INFO;
 117
 118 typedef const DSOP_INIT_INFO *PCDSOP_INIT_INFO;
 119
 120 /* selection scope types in the DS_SELECTION structure */
 121 #define DSOP_SCOPE_TYPE_TARGET_COMPUTER (0x1)
 122 #define DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN   (0x2)
 123 #define DSOP_SCOPE_TYPE_DOWNLEVEL_JOINED_DOMAIN (0x4)
 124 #define DSOP_SCOPE_TYPE_ENTERPRISE_DOMAIN       (0x8)
 125 #define DSOP_SCOPE_TYPE_GLOBAL_CATALOG  (0x10)
 126 #define DSOP_SCOPE_TYPE_EXTERNAL_UPLEVEL_DOMAIN (0x20)
 127 #define DSOP_SCOPE_TYPE_EXTERNAL_DOWNLEVEL_DOMAIN       (0x40)
 128 #define DSOP_SCOPE_TYPE_WORKGROUP       (0x80)
 129 #define DSOP_SCOPE_TYPE_USER_ENTERED_UPLEVEL_SCOPE      (0x100)
 130 #define DSOP_SCOPE_TYPE_USER_ENTERED_DOWNLEVEL_SCOPE    (0x200)
 131
 132 typedef struct _DS_SELECTION
 133 {
 134     PWSTR pwzName;
 135     PWSTR pwzADsPath;
 136     PWSTR pwzClass;
 137     PWSTR pwzUPN;
 138     VARIANT *pvarFetchedAttributes;
 139     ULONG flScopeType;
 140 } DS_SELECTION, *PDS_SELECTION;
 141
 142 typedef struct _DS_SELECTION_LIST
 143 {
 144     ULONG cItems;
 145     ULONG cFetchedAttributes;
 146     DS_SELECTION aDsSelection[ANYSIZE_ARRAY];
 147 } DS_SELECTION_LIST, *PDS_SELECTION_LIST;
 148
 149 /*****************************************************************************
 150  * IDsObjectPicker interface
 151  */
 152 #define INTERFACE   IDsObjectPicker
 153 DECLARE_INTERFACE_(IDsObjectPicker,IUnknown)
 154 {
 155     /*** IUnknown methods ***/
 156     STDMETHOD_(HRESULT,QueryInterface)(THIS_ REFIID riid, void** ppvObject) PURE;
 157     STDMETHOD_(ULONG,AddRef)(THIS) PURE;
 158     STDMETHOD_(ULONG,Release)(THIS) PURE;
 159     /*** IDsObjectPicker methods ***/
 160     STDMETHOD(Initialize)(THIS_ PDSOP_INIT_INFO pInitInfo) PURE;
 161     STDMETHOD(InvokeDialog)(THIS_ HWND hwndParent, IDataObject** ppdoSelections) PURE;
 162 };
 163 #undef INTERFACE
 164
 165
 166 #ifdef __cplusplus
 167 }
 168 #endif
 169 #endif /* __OBJSEL_H_ */