master
  1/**
  2 * This file is part of the mingw-w64 runtime package.
  3 * No warranty is given; refer to the file DISCLAIMER within this package.
  4 */
  5#ifndef _ACLUI_H_
  6#define _ACLUI_H_
  7
  8#include <winapifamily.h>
  9
 10#if WINAPI_FAMILY_PARTITION (WINAPI_PARTITION_DESKTOP)
 11
 12#include <objbase.h>
 13#include <commctrl.h>
 14#include <accctrl.h>
 15#include <authz.h>
 16
 17#ifndef _ACLUI_
 18#define ACLUIAPI DECLSPEC_IMPORT WINAPI
 19#else
 20#define ACLUIAPI WINAPI
 21#endif
 22
 23#ifdef __cplusplus
 24extern "C" {
 25#endif
 26
 27  typedef struct _SI_OBJECT_INFO {
 28    DWORD dwFlags;
 29    HINSTANCE hInstance;
 30    LPWSTR pszServerName;
 31    LPWSTR pszObjectName;
 32    LPWSTR pszPageTitle;
 33    GUID guidObjectType;
 34  } SI_OBJECT_INFO,*PSI_OBJECT_INFO;
 35
 36#define SI_EDIT_PERMS __MSABI_LONG(0x00000000)
 37#define SI_EDIT_OWNER __MSABI_LONG(0x00000001)
 38#define SI_EDIT_AUDITS __MSABI_LONG(0x00000002)
 39#define SI_CONTAINER __MSABI_LONG(0x00000004)
 40#define SI_READONLY __MSABI_LONG(0x00000008)
 41#define SI_ADVANCED __MSABI_LONG(0x00000010)
 42#define SI_RESET __MSABI_LONG(0x00000020)
 43#define SI_OWNER_READONLY __MSABI_LONG(0x00000040)
 44#define SI_EDIT_PROPERTIES __MSABI_LONG(0x00000080)
 45#define SI_OWNER_RECURSE __MSABI_LONG(0x00000100)
 46#define SI_NO_ACL_PROTECT __MSABI_LONG(0x00000200)
 47#define SI_NO_TREE_APPLY __MSABI_LONG(0x00000400)
 48#define SI_PAGE_TITLE __MSABI_LONG(0x00000800)
 49#define SI_SERVER_IS_DC __MSABI_LONG(0x00001000)
 50#define SI_RESET_DACL_TREE __MSABI_LONG(0x00004000)
 51#define SI_RESET_SACL_TREE __MSABI_LONG(0x00008000)
 52#define SI_OBJECT_GUID __MSABI_LONG(0x00010000)
 53#define SI_EDIT_EFFECTIVE __MSABI_LONG(0x00020000)
 54#define SI_RESET_DACL __MSABI_LONG(0x00040000)
 55#define SI_RESET_SACL __MSABI_LONG(0x00080000)
 56#define SI_RESET_OWNER __MSABI_LONG(0x00100000)
 57#define SI_NO_ADDITIONAL_PERMISSION __MSABI_LONG(0x00200000)
 58#if NTDDI_VERSION >= 0x06000000
 59#define SI_VIEW_ONLY __MSABI_LONG(0x00400000)
 60#define SI_PERMS_ELEVATION_REQUIRED __MSABI_LONG(0x01000000)
 61#define SI_AUDITS_ELEVATION_REQUIRED __MSABI_LONG(0x02000000)
 62#define SI_OWNER_ELEVATION_REQUIRED __MSABI_LONG(0x04000000)
 63#endif
 64#if NTDDI_VERSION >= 0x06020000
 65#define SI_SCOPE_ELEVATION_REQUIRED __MSABI_LONG(0x08000000)
 66#endif
 67#define SI_MAY_WRITE __MSABI_LONG(0x10000000)
 68#if NTDDI_VERSION >= 0x06020000
 69#define SI_ENABLE_EDIT_ATTRIBUTE_CONDITION __MSABI_LONG(0x20000000)
 70#define SI_ENABLE_CENTRAL_POLICY __MSABI_LONG(0x40000000)
 71#define SI_DISABLE_DENY_ACE __MSABI_LONG(0x80000000)
 72#endif
 73
 74#define SI_EDIT_ALL (SI_EDIT_PERMS | SI_EDIT_OWNER | SI_EDIT_AUDITS)
 75
 76  typedef struct _SI_ACCESS {
 77    const GUID *pguid;
 78    ACCESS_MASK mask;
 79    LPCWSTR pszName;
 80    DWORD dwFlags;
 81  } SI_ACCESS, *PSI_ACCESS;
 82
 83#define SI_ACCESS_SPECIFIC __MSABI_LONG(0x00010000)
 84#define SI_ACCESS_GENERAL __MSABI_LONG(0x00020000)
 85#define SI_ACCESS_CONTAINER __MSABI_LONG(0x00040000)
 86#define SI_ACCESS_PROPERTY __MSABI_LONG(0x00080000)
 87
 88  typedef struct _SI_INHERIT_TYPE {
 89    const GUID *pguid;
 90    ULONG dwFlags;
 91    LPCWSTR pszName;
 92  } SI_INHERIT_TYPE, *PSI_INHERIT_TYPE;
 93
 94  typedef enum _SI_PAGE_TYPE {
 95    SI_PAGE_PERM=0,
 96    SI_PAGE_ADVPERM,
 97    SI_PAGE_AUDIT,
 98    SI_PAGE_OWNER,
 99    SI_PAGE_EFFECTIVE
100#if NTDDI_VERSION >= 0x06000000
101    , SI_PAGE_TAKEOWNERSHIP
102#endif
103#if NTDDI_VERSION >= 0x06020000
104    , SI_PAGE_SHARE
105#endif
106  } SI_PAGE_TYPE;
107
108  typedef enum _SI_PAGE_ACTIVATED {
109    SI_SHOW_DEFAULT=0,
110    SI_SHOW_PERM_ACTIVATED,
111    SI_SHOW_AUDIT_ACTIVATED,
112    SI_SHOW_OWNER_ACTIVATED,
113    SI_SHOW_EFFECTIVE_ACTIVATED,
114    SI_SHOW_SHARE_ACTIVATED,
115    SI_SHOW_CENTRAL_POLICY_ACTIVATED
116  } SI_PAGE_ACTIVATED;
117
118#define GET_PAGE_TYPE(X) (UINT) ((X) &0x0000ffff)
119#define GET_ACTIVATION_TYPE(Y) (UINT) (((Y) >> 16) &0x0000ffff)
120#define COMBINE_PAGE_ACTIVATION(X, Y) (UINT) (((Y) << 16) | X)
121
122#define DOBJ_RES_CONT __MSABI_LONG(0x00000001)
123#define DOBJ_RES_ROOT __MSABI_LONG(0x00000002)
124#define DOBJ_VOL_NTACLS __MSABI_LONG(0x00000004)
125#define DOBJ_COND_NTACLS __MSABI_LONG(0x00000008)
126#define DOBJ_RIBBON_LAUNCH __MSABI_LONG(0x00000010)
127
128#define PSPCB_SI_INITDIALOG (WM_USER + 1)
129
130#undef INTERFACE
131#define INTERFACE ISecurityInformation
132
133  DECLARE_INTERFACE_IID_ (ISecurityInformation, IUnknown, "965FC360-16FF-11d0-91CB-00AA00BBB723") {
134    STDMETHOD (QueryInterface) (THIS_ REFIID riid, void **ppvObj) PURE;
135    STDMETHOD_ (ULONG, AddRef) (THIS) PURE;
136    STDMETHOD_ (ULONG, Release) (THIS) PURE;
137    STDMETHOD (GetObjectInformation) (THIS_ PSI_OBJECT_INFO pObjectInfo) PURE;
138    STDMETHOD (GetSecurity) (THIS_ SECURITY_INFORMATION RequestedInformation, PSECURITY_DESCRIPTOR *ppSecurityDescriptor, WINBOOL fDefault) PURE;
139    STDMETHOD (SetSecurity) (THIS_ SECURITY_INFORMATION SecurityInformation, PSECURITY_DESCRIPTOR pSecurityDescriptor) PURE;
140    STDMETHOD (GetAccessRights) (THIS_ const GUID *pguidObjectType, DWORD dwFlags, PSI_ACCESS *ppAccess, ULONG *pcAccesses, ULONG *piDefaultAccess) PURE;
141    STDMETHOD (MapGeneric) (THIS_ const GUID *pguidObjectType, UCHAR *pAceFlags, ACCESS_MASK *pMask) PURE;
142    STDMETHOD (GetInheritTypes) (THIS_ PSI_INHERIT_TYPE *ppInheritTypes, ULONG *pcInheritTypes) PURE;
143    STDMETHOD (PropertySheetPageCallback) (THIS_ HWND hwnd, UINT uMsg, SI_PAGE_TYPE uPage) PURE;
144  };
145
146  typedef ISecurityInformation *LPSECURITYINFO;
147#undef INTERFACE
148#define INTERFACE ISecurityInformation2
149
150  DECLARE_INTERFACE_IID_ (ISecurityInformation2, IUnknown, "c3ccfdb4-6f88-11d2-a3ce-00c04fb1782a") {
151    STDMETHOD (QueryInterface) (THIS_ REFIID riid, void **ppvObj) PURE;
152    STDMETHOD_ (ULONG, AddRef) (THIS) PURE;
153    STDMETHOD_ (ULONG, Release) (THIS) PURE;
154    STDMETHOD_ (WINBOOL, IsDaclCanonical) (THIS_ PACL pDacl) PURE;
155    STDMETHOD (LookupSids) (THIS_ ULONG cSids, PSID *rgpSids, LPDATAOBJECT *ppdo) PURE;
156  };
157
158  typedef ISecurityInformation2 *LPSECURITYINFO2;
159
160#define CFSTR_ACLUI_SID_INFO_LIST TEXT ("CFSTR_ACLUI_SID_INFO_LIST")
161
162  typedef struct _SID_INFO {
163    PSID pSid;
164    PWSTR pwzCommonName;
165    PWSTR pwzClass;
166    PWSTR pwzUPN;
167  } SID_INFO, *PSID_INFO;
168
169  typedef struct _SID_INFO_LIST {
170    ULONG cItems;
171    SID_INFO aSidInfo[ANYSIZE_ARRAY];
172  } SID_INFO_LIST, *PSID_INFO_LIST;
173
174#undef INTERFACE
175#define INTERFACE IEffectivePermission
176
177  DECLARE_INTERFACE_IID_ (IEffectivePermission, IUnknown, "3853DC76-9F35-407c-88A1-D19344365FBC") {
178    STDMETHOD (QueryInterface) (THIS_ REFIID riid, void **ppvObj) PURE;
179    STDMETHOD_ (ULONG, AddRef) (THIS) PURE;
180    STDMETHOD_ (ULONG, Release) (THIS) PURE;
181    STDMETHOD (GetEffectivePermission) (THIS_ const GUID *pguidObjectType, PSID pUserSid, LPCWSTR pszServerName, PSECURITY_DESCRIPTOR pSD, POBJECT_TYPE_LIST *ppObjectTypeList, ULONG *pcObjectTypeListLength, PACCESS_MASK *ppGrantedAccessList, ULONG *pcGrantedAccessListLength) PURE;
182  };
183
184  typedef IEffectivePermission *LPEFFECTIVEPERMISSION;
185
186#undef INTERFACE
187#define INTERFACE ISecurityObjectTypeInfo
188
189  DECLARE_INTERFACE_IID_ (ISecurityObjectTypeInfo, IUnknown, "FC3066EB-79EF-444b-9111-D18A75EBF2FA") {
190    STDMETHOD (QueryInterface) (THIS_ REFIID riid, void **ppvObj) PURE;
191    STDMETHOD_ (ULONG, AddRef) (THIS) PURE;
192    STDMETHOD_ (ULONG, Release) (THIS) PURE;
193    STDMETHOD (GetInheritSource) (SECURITY_INFORMATION si, PACL pACL, PINHERITED_FROM *ppInheritArray) PURE;
194  };
195
196  typedef ISecurityObjectTypeInfo *LPSecurityObjectTypeInfo;
197
198#if NTDDI_VERSION >= 0x06000000
199#undef INTERFACE
200#define INTERFACE ISecurityInformation3
201  DECLARE_INTERFACE_IID_ (ISecurityInformation3, IUnknown, "E2CDC9CC-31BD-4f8f-8C8B-B641AF516A1A") {
202    STDMETHOD (QueryInterface) (THIS_ REFIID riid, void **ppvObj) PURE;
203    STDMETHOD_ (ULONG, AddRef) (THIS) PURE;
204    STDMETHOD_ (ULONG, Release) (THIS) PURE;
205    STDMETHOD (GetFullResourceName) (THIS_ LPWSTR *ppszResourceName) PURE;
206    STDMETHOD (OpenElevatedEditor) (THIS_ HWND hWnd, SI_PAGE_TYPE uPage) PURE;
207  };
208
209  typedef ISecurityInformation3 *LPSECURITYINFO3;
210#endif
211
212#if NTDDI_VERSION >= 0x06020000
213  typedef struct _SECURITY_OBJECT {
214    PWSTR pwszName;
215    PVOID pData;
216    DWORD cbData;
217    PVOID pData2;
218    DWORD cbData2;
219    DWORD Id;
220    BOOLEAN fWellKnown;
221  } SECURITY_OBJECT, *PSECURITY_OBJECT;
222
223#define SECURITY_OBJECT_ID_OBJECT_SD 1
224#define SECURITY_OBJECT_ID_SHARE 2
225#define SECURITY_OBJECT_ID_CENTRAL_POLICY 3
226#define SECURITY_OBJECT_ID_CENTRAL_ACCESS_RULE 4
227
228  typedef struct _EFFPERM_RESULT_LIST {
229    BOOLEAN fEvaluated;
230    ULONG cObjectTypeListLength;
231    OBJECT_TYPE_LIST *pObjectTypeList;
232    ACCESS_MASK *pGrantedAccessList;
233  } EFFPERM_RESULT_LIST, *PEFFPERM_RESULT_LIST;
234
235#undef INTERFACE
236#define INTERFACE ISecurityInformation4
237
238  DECLARE_INTERFACE_IID_ (ISecurityInformation4, IUnknown, "EA961070-CD14-4621-ACE4-F63C03E583E4") {
239    STDMETHOD (QueryInterface) (THIS_ REFIID riid, void **ppvObj) PURE;
240    STDMETHOD_ (ULONG, AddRef) (THIS) PURE;
241    STDMETHOD_ (ULONG, Release) (THIS) PURE;
242    STDMETHOD (GetSecondarySecurity) (THIS_ PSECURITY_OBJECT *pSecurityObjects, PULONG pSecurityObjectCount) PURE;
243  };
244
245  typedef ISecurityInformation4 *LPSECURITYINFO4;
246
247#undef INTERFACE
248#define INTERFACE IEffectivePermission
249
250  DECLARE_INTERFACE_IID_ (IEffectivePermission2, IUnknown, "941FABCA-DD47-4FCA-90BB-B0E10255F20D") {
251    STDMETHOD (QueryInterface) (THIS_ REFIID riid, void **ppvObj) PURE;
252    STDMETHOD_ (ULONG, AddRef) (THIS) PURE;
253    STDMETHOD_ (ULONG, Release) (THIS) PURE;
254    STDMETHOD (ComputeEffectivePermissionWithSecondarySecurity) (THIS_ PSID pSid, PSID pDeviceSid, PCWSTR pszServerName, PSECURITY_OBJECT pSecurityObjects, DWORD dwSecurityObjectCount, PTOKEN_GROUPS pUserGroups, PAUTHZ_SID_OPERATION pAuthzUserGroupsOperations, PTOKEN_GROUPS pDeviceGroups, PAUTHZ_SID_OPERATION pAuthzDeviceGroupsOperations, PAUTHZ_SECURITY_ATTRIBUTES_INFORMATION pAuthzUserClaims, PAUTHZ_SECURITY_ATTRIBUTE_OPERATION pAuthzUserClaimsOperations, PAUTHZ_SECURITY_ATTRIBUTES_INFORMATION pAuthzDeviceClaims, PAUTHZ_SECURITY_ATTRIBUTE_OPERATION pAuthzDeviceClaimsOperations, PEFFPERM_RESULT_LIST pEffpermResultLists);
255  };
256
257  typedef IEffectivePermission2 *LPEFFECTIVEPERMISSION2;
258#endif
259
260  EXTERN_GUID (IID_ISecurityInformation, 0x965fc360, 0x16ff, 0x11d0, 0x91, 0xcb, 0x0, 0xaa, 0x0, 0xbb, 0xb7, 0x23);
261  EXTERN_GUID (IID_ISecurityInformation2, 0xc3ccfdb4, 0x6f88, 0x11d2, 0xa3, 0xce, 0x0, 0xc0, 0x4f, 0xb1, 0x78, 0x2a);
262  EXTERN_GUID (IID_IEffectivePermission, 0x3853dc76, 0x9f35, 0x407c, 0x88, 0xa1, 0xd1, 0x93, 0x44, 0x36, 0x5f, 0xbc);
263  EXTERN_GUID (IID_ISecurityObjectTypeInfo, 0xfc3066eb, 0x79ef, 0x444b, 0x91, 0x11, 0xd1, 0x8a, 0x75, 0xeb, 0xf2, 0xfa);
264#if NTDDI_VERSION >= 0x06000000
265  EXTERN_GUID (IID_ISecurityInformation3, 0xe2cdc9cc, 0x31bd, 0x4f8f, 0x8c, 0x8b, 0xb6, 0x41, 0xaf, 0x51, 0x6a, 0x1a);
266#endif
267#if NTDDI_VERSION >= 0x06020000
268  EXTERN_GUID (IID_ISecurityInformation4, 0xea961070, 0xcd14, 0x4621, 0xac, 0xe4, 0xf6, 0x3c, 0x3, 0xe5, 0x83, 0xe4);
269  EXTERN_GUID (IID_IEffectivePermission2, 0x941fabca, 0xdd47, 0x4fca, 0x90, 0xbb, 0xb0, 0xe1, 0x2, 0x55, 0xf2, 0xd);
270#endif
271
272  HPROPSHEETPAGE ACLUIAPI CreateSecurityPage (LPSECURITYINFO psi);
273  WINBOOL ACLUIAPI EditSecurity (HWND hwndOwner, LPSECURITYINFO psi);
274#if NTDDI_VERSION >= 0x06000000
275  HRESULT ACLUIAPI EditSecurityAdvanced (HWND hwndOwner, LPSECURITYINFO psi, SI_PAGE_TYPE uSIPage);
276#endif
277
278#ifdef __cplusplus
279}
280#endif
281#endif
282#endif