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 #define DSOP_FILTER_SERVICE_ACCOUNTS            (0x1000)
  43 #define DSOP_FILTER_PASSWORDSETTINGS_OBJECTS    (0x2000)
  44
  45 typedef struct _DSOP_UPLEVEL_FILTER_FLAGS
  46 {
  47     ULONG flBothModes;
  48     ULONG flMixedModeOnly;
  49     ULONG flNativeModeOnly;
  50 } DSOP_UPLEVEL_FILTER_FLAGS, *PDSOP_UPLEVEL_FILTER_FLAGS;
  51
  52 /* down-level scope filters in the DSOP_FILTER_FLAGS structure */
  53 #define DSOP_DOWNLEVEL_FILTER_USERS     (0x80000001)
  54 #define DSOP_DOWNLEVEL_FILTER_LOCAL_GROUPS      (0x80000002)
  55 #define DSOP_DOWNLEVEL_FILTER_GLOBAL_GROUPS     (0x80000004)
  56 #define DSOP_DOWNLEVEL_FILTER_COMPUTERS (0x80000008)
  57 #define DSOP_DOWNLEVEL_FILTER_WORLD     (0x80000010)
  58 #define DSOP_DOWNLEVEL_FILTER_AUTHENTICATED_USER        (0x80000020)
  59 #define DSOP_DOWNLEVEL_FILTER_ANONYMOUS (0x80000040)
  60 #define DSOP_DOWNLEVEL_FILTER_BATCH     (0x80000080)
  61 #define DSOP_DOWNLEVEL_FILTER_CREATOR_OWNER     (0x80000100)
  62 #define DSOP_DOWNLEVEL_FILTER_CREATOR_GROUP     (0x80000200)
  63 #define DSOP_DOWNLEVEL_FILTER_DIALUP    (0x80000400)
  64 #define DSOP_DOWNLEVEL_FILTER_INTERACTIVE       (0x80000800)
  65 #define DSOP_DOWNLEVEL_FILTER_NETWORK   (0x80001000)
  66 #define DSOP_DOWNLEVEL_FILTER_SERVICE   (0x80002000)
  67 #define DSOP_DOWNLEVEL_FILTER_SYSTEM    (0x80004000)
  68 #define DSOP_DOWNLEVEL_FILTER_EXCLUDE_BUILTIN_GROUPS    (0x80008000)
  69 #define DSOP_DOWNLEVEL_FILTER_TERMINAL_SERVER   (0x80010000)
  70 #define DSOP_DOWNLEVEL_FILTER_ALL_WELLKNOWN_SIDS        (0x80020000)
  71 #define DSOP_DOWNLEVEL_FILTER_LOCAL_SERVICE     (0x80040000)
  72 #define DSOP_DOWNLEVEL_FILTER_NETWORK_SERVICE   (0x80080000)
  73 #define DSOP_DOWNLEVEL_FILTER_REMOTE_LOGON      (0x80100000)
  74
  75 typedef struct _DSOP_FILTER_FLAGS
  76 {
  77     DSOP_UPLEVEL_FILTER_FLAGS Uplevel;
  78     ULONG flDownlevel;
  79 } DSOP_FILTER_FLAGS, *PDSOP_FILTER_FLAGS;
  80
  81 /* ADsPath format flags in the DSOP_SCOPE_INIT_INFO structure */
  82 #define DSOP_SCOPE_FLAG_STARTING_SCOPE  (0x1)
  83 #define DSOP_SCOPE_FLAG_WANT_PROVIDER_WINNT     (0x2)
  84 #define DSOP_SCOPE_FLAG_WANT_PROVIDER_LDAP      (0x4)
  85 #define DSOP_SCOPE_FLAG_WANT_PROVIDER_GC        (0x8)
  86 #define DSOP_SCOPE_FLAG_WANT_SID_PATH   (0x10)
  87 #define DSOP_SCOPE_FLAG_WANT_DOWNLEVEL_BUILTIN_PATH     (0x20)
  88 #define DSOP_SCOPE_FLAG_DEFAULT_FILTER_USERS    (0x40)
  89 #define DSOP_SCOPE_FLAG_DEFAULT_FILTER_GROUPS   (0x80)
  90 #define DSOP_SCOPE_FLAG_DEFAULT_FILTER_COMPUTERS        (0x100)
  91 #define DSOP_SCOPE_FLAG_DEFAULT_FILTER_CONTACTS (0x200)
  92 #define DSOP_SCOPE_FLAG_DEFAULT_FILTER_SERVICE_ACCOUNTS         (0x400)
  93 #define DSOP_SCOPE_FLAG_DEFAULT_FILTER_PASSWORDSETTINGS_OBJECTS (0x800)
  94
  95 typedef struct _DSOP_SCOPE_INIT_INFO
  96 {
  97     ULONG cbSize;
  98     ULONG flType;
  99     ULONG flScope;
 100     DSOP_FILTER_FLAGS FilterFlags;
 101     PCWSTR pwzDcName;
 102     PCWSTR pwzADsPath;
 103     HRESULT hr;
 104 } DSOP_SCOPE_INIT_INFO, *PDSOP_SCOPE_INIT_INFO;
 105 typedef const DSOP_SCOPE_INIT_INFO *PCDSOP_SCOPE_INIT_INFO;
 106
 107 /* object picker options in the DSOP_INIT_INFO structure */
 108 #define DSOP_FLAG_MULTISELECT   (0x1)
 109 #define DSOP_FLAG_SKIP_TARGET_COMPUTER_DC_CHECK (0x2)
 110
 111 typedef struct _DSOP_INIT_INFO
 112 {
 113     ULONG cbSize;
 114     PCWSTR pwzTargetComputer;
 115     ULONG cDsScopeInfos;
 116     PDSOP_SCOPE_INIT_INFO aDsScopeInfos;
 117     ULONG flOptions;
 118     ULONG cAttributesToFetch;
 119     PCWSTR *apwzAttributeNames;
 120 } DSOP_INIT_INFO, *PDSOP_INIT_INFO;
 121
 122 typedef const DSOP_INIT_INFO *PCDSOP_INIT_INFO;
 123
 124 /* selection scope types in the DS_SELECTION structure */
 125 #define DSOP_SCOPE_TYPE_TARGET_COMPUTER (0x1)
 126 #define DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN   (0x2)
 127 #define DSOP_SCOPE_TYPE_DOWNLEVEL_JOINED_DOMAIN (0x4)
 128 #define DSOP_SCOPE_TYPE_ENTERPRISE_DOMAIN       (0x8)
 129 #define DSOP_SCOPE_TYPE_GLOBAL_CATALOG  (0x10)
 130 #define DSOP_SCOPE_TYPE_EXTERNAL_UPLEVEL_DOMAIN (0x20)
 131 #define DSOP_SCOPE_TYPE_EXTERNAL_DOWNLEVEL_DOMAIN       (0x40)
 132 #define DSOP_SCOPE_TYPE_WORKGROUP       (0x80)
 133 #define DSOP_SCOPE_TYPE_USER_ENTERED_UPLEVEL_SCOPE      (0x100)
 134 #define DSOP_SCOPE_TYPE_USER_ENTERED_DOWNLEVEL_SCOPE    (0x200)
 135
 136 typedef struct _DS_SELECTION
 137 {
 138     PWSTR pwzName;
 139     PWSTR pwzADsPath;
 140     PWSTR pwzClass;
 141     PWSTR pwzUPN;
 142     VARIANT *pvarFetchedAttributes;
 143     ULONG flScopeType;
 144 } DS_SELECTION, *PDS_SELECTION;
 145
 146 typedef struct _DS_SELECTION_LIST
 147 {
 148     ULONG cItems;
 149     ULONG cFetchedAttributes;
 150     DS_SELECTION aDsSelection[ANYSIZE_ARRAY];
 151 } DS_SELECTION_LIST, *PDS_SELECTION_LIST;
 152
 153 /*****************************************************************************
 154  * IDsObjectPicker interface
 155  */
 156 #define INTERFACE   IDsObjectPicker
 157 DECLARE_INTERFACE_(IDsObjectPicker,IUnknown)
 158 {
 159     /*** IUnknown methods ***/
 160     STDMETHOD_(HRESULT,QueryInterface)(THIS_ REFIID riid, void** ppvObject) PURE;
 161     STDMETHOD_(ULONG,AddRef)(THIS) PURE;
 162     STDMETHOD_(ULONG,Release)(THIS) PURE;
 163     /*** IDsObjectPicker methods ***/
 164     STDMETHOD(Initialize)(THIS_ PDSOP_INIT_INFO pInitInfo) PURE;
 165     STDMETHOD(InvokeDialog)(THIS_ HWND hwndParent, IDataObject** ppdoSelections) PURE;
 166 };
 167 #undef INTERFACE
 168
 169
 170 #ifdef __cplusplus
 171 }
 172 #endif
 173 #endif /* __OBJSEL_H_ */