home *** CD-ROM | disk | FTP | other *** search
/ PC Format (South-Africa) 2001 June / PCFJune.iso / Xenon / C++ / FreeCommandLineTools.exe / Include / sddl.h < prev    next >
Encoding:
C/C++ Source or Header  |  2000-01-31  |  9.2 KB  |  251 lines
  1. /*++
  2.  
  3. Copyright (c) 1997-1998  Microsoft Corporation
  4.  
  5. Module Name:
  6.  
  7.     sddl.w
  8.  
  9. Abstract:
  10.  
  11.     This module defines the support and conversions routines necessary for SDDL.
  12.  
  13. Revision History:
  14.  
  15. --*/
  16.  
  17. #ifndef __SDDL_H__
  18. #pragma option push -b -a8 -pc -A- /*P_O_Push*/
  19. #define __SDDL_H__
  20.  
  21.  
  22. #ifdef __cplusplus
  23. extern "C" {
  24. #endif
  25.  
  26. //
  27. // SDDL Version information
  28. //
  29. #define SDDL_REVISION_1     1
  30. #define SDDL_REVISION       SDDL_REVISION_1
  31.  
  32. //
  33. // SDDL Component tags
  34. //
  35. #define SDDL_OWNER                          TEXT("O")       // Owner tag
  36. #define SDDL_GROUP                          TEXT("G")       // Group tag
  37. #define SDDL_DACL                           TEXT("D")       // DACL tag
  38. #define SDDL_SACL                           TEXT("S")       // SACL tag
  39.  
  40. //
  41. // SDDL Security descriptor controls
  42. //
  43. #define SDDL_PROTECTED                      TEXT("P")       // DACL or SACL Protected
  44. #define SDDL_AUTO_INHERIT_REQ               TEXT("AR")      // Auto inherit request
  45. #define SDDL_AUTO_INHERITED                 TEXT("AI")      // DACL/SACL are auto inherited
  46.  
  47. //
  48. // SDDL Ace types
  49. //
  50. #define SDDL_ACCESS_ALLOWED                 TEXT("A")   // Access allowed
  51. #define SDDL_ACCESS_DENIED                  TEXT("D")   // Access denied
  52. #define SDDL_OBJECT_ACCESS_ALLOWED          TEXT("OA")  // Object access allowed
  53. #define SDDL_OBJECT_ACCESS_DENIED           TEXT("OD")  // Object access denied
  54. #define SDDL_AUDIT                          TEXT("AU")  // Audit
  55. #define SDDL_ALARM                          TEXT("AL")  // Alarm
  56. #define SDDL_OBJECT_AUDIT                   TEXT("OU")  // Object audit
  57. #define SDDL_OBJECT_ALARM                   TEXT("OL")  // Object alarm
  58.  
  59. //
  60. // SDDL Ace flags
  61. //
  62. #define SDDL_CONTAINER_INHERIT              TEXT("CI")  // Container inherit
  63. #define SDDL_OBJECT_INHERIT                 TEXT("OI")  // Object inherit
  64. #define SDDL_NO_PROPAGATE                   TEXT("NP")  // Inherit no propagate
  65. #define SDDL_INHERIT_ONLY                   TEXT("IO")  // Inherit only
  66. #define SDDL_INHERITED                      TEXT("ID")  // Inherited
  67. #define SDDL_AUDIT_SUCCESS                  TEXT("SA")  // Audit success
  68. #define SDDL_AUDIT_FAILURE                  TEXT("FA")  // Audit failure
  69.  
  70.  
  71. //
  72. // SDDL Rights
  73. //
  74. #define SDDL_READ_PROPERTY                  TEXT("RP")
  75. #define SDDL_WRITE_PROPERTY                 TEXT("WP")
  76. #define SDDL_CREATE_CHILD                   TEXT("CC")
  77. #define SDDL_DELETE_CHILD                   TEXT("DC")
  78. #define SDDL_LIST_CHILDREN                  TEXT("LC")
  79. #define SDDL_SELF_WRITE                     TEXT("SW")
  80. #define SDDL_LIST_OBJECT                    TEXT("LO")
  81. #define SDDL_DELETE_TREE                    TEXT("DT")
  82. #define SDDL_CONTROL_ACCESS                 TEXT("CR")
  83. #define SDDL_READ_CONTROL                   TEXT("RC")
  84. #define SDDL_WRITE_DAC                      TEXT("WD")
  85. #define SDDL_WRITE_OWNER                    TEXT("WO")
  86. #define SDDL_STANDARD_DELETE                TEXT("SD")
  87. #define SDDL_GENERIC_ALL                    TEXT("GA")
  88. #define SDDL_GENERIC_READ                   TEXT("GR")
  89. #define SDDL_GENERIC_WRITE                  TEXT("GW")
  90. #define SDDL_GENERIC_EXECUTE                TEXT("GX")
  91. #define SDDL_FILE_ALL                       TEXT("FA")
  92. #define SDDL_FILE_READ                      TEXT("FR")
  93. #define SDDL_FILE_WRITE                     TEXT("FW")
  94. #define SDDL_FILE_EXECUTE                   TEXT("FX")
  95. #define SDDL_KEY_ALL                        TEXT("KA")
  96. #define SDDL_KEY_READ                       TEXT("KR")
  97. #define SDDL_KEY_WRITE                      TEXT("KW")
  98. #define SDDL_KEY_EXECUTE                    TEXT("KX")
  99.  
  100. //
  101. // SDDL User aliases
  102. //
  103. #define SDDL_DOMAIN_ADMINISTRATORS          TEXT("DA")      // Domain admins
  104. #define SDDL_DOMAIN_GUESTS                  TEXT("DG")      // Domain guests
  105. #define SDDL_DOMAIN_USERS                   TEXT("DU")      // Domain users
  106. #define SDDL_ENTERPRISE_DOMAIN_CONTROLLERS  TEXT("ED")      // Enterprise domain controllers
  107. #define SDDL_DOMAIN_DOMAIN_CONTROLLERS      TEXT("DD")      // Domain domain controllers
  108. #define SDDL_DOMAIN_COMPUTERS               TEXT("DC")      // Domain computers
  109. #define SDDL_BUILTIN_ADMINISTRATORS         TEXT("BA")      // Builtin (local ) administrators
  110. #define SDDL_BUILTIN_GUESTS                 TEXT("BG")      // Builtin (local ) guests
  111. #define SDDL_BUILTIN_USERS                  TEXT("BU")      // Builtin (local ) users
  112. #define SDDL_LOCAL_ADMIN                    TEXT("LA")      // Local administrator account
  113. #define SDDL_LOCAL_GUEST                    TEXT("LG")      // Local group account
  114. #define SDDL_ACCOUNT_OPERATORS              TEXT("AO")      // Account operators
  115. #define SDDL_BACKUP_OPERATORS               TEXT("BO")      // Backup operators
  116. #define SDDL_PRINTER_OPERATORS              TEXT("PO")      // Printer operators
  117. #define SDDL_SERVER_OPERATORS               TEXT("SO")      // Server operators
  118. #define SDDL_AUTHENTICATED_USERS            TEXT("AU")      // Authenticated users
  119. #define SDDL_PERSONAL_SELF                  TEXT("PS")      // Personal self
  120. #define SDDL_CREATOR_OWNER                  TEXT("CO")      // Creator owner
  121. #define SDDL_CREATOR_GROUP                  TEXT("CG")      // Creator group
  122. #define SDDL_LOCAL_SYSTEM                   TEXT("SY")      // Local system
  123. #define SDDL_POWER_USERS                    TEXT("PU")      // Power users
  124. #define SDDL_EVERYONE                       TEXT("WD")      // Everyone ( World )
  125. #define SDDL_REPLICATOR                     TEXT("RE")      // Replicator
  126. #define SDDL_INTERACTIVE                    TEXT("IU")      // Interactive logon user
  127. #define SDDL_NETWORK                        TEXT("NU")      // Nework logon user
  128. #define SDDL_SERVICE                        TEXT("SU")      // Service logon user
  129. #define SDDL_RESTRICTED_CODE                TEXT("RC")      // Restricted code
  130. #define SDDL_SCHEMA_ADMINISTRATORS          TEXT("SA")      // Schema Administrators
  131. #define SDDL_CERT_SERV_ADMINISTRATORS       TEXT("CA")      // Certificate Server Administrators
  132. #define SDDL_RAS_SERVERS                    TEXT("RS")      // RAS servers group
  133. #define SDDL_ENTERPRISE_ADMINS              TEXT("EA")      // Enterprise administrators
  134. #define SDDL_GROUP_POLICY_ADMINS            TEXT("PA")      // Group Policy administrators
  135. #define SDDL_ALIAS_PREW2KCOMPACC            TEXT("RU")      // alias to allow previous windows 2000
  136.  
  137.  
  138. //
  139. // SDDL Seperators
  140. //
  141. #define SDDL_SEPERATORC                     TEXT(';')
  142. #define SDDL_DELIMINATORC                   TEXT(':')
  143. #define SDDL_ACE_BEGINC                     TEXT('(')
  144. #define SDDL_ACE_ENDC                       TEXT(')')
  145.  
  146.  
  147. #if(_WIN32_WINNT >= 0x0500)
  148.  
  149. WINADVAPI
  150. BOOL
  151. WINAPI
  152. ConvertSidToStringSidA(
  153.     IN  PSID     Sid,
  154.     OUT LPSTR  *StringSid
  155.     );
  156. WINADVAPI
  157. BOOL
  158. WINAPI
  159. ConvertSidToStringSidW(
  160.     IN  PSID     Sid,
  161.     OUT LPWSTR  *StringSid
  162.     );
  163. #ifdef UNICODE
  164. #define ConvertSidToStringSid  ConvertSidToStringSidW
  165. #else
  166. #define ConvertSidToStringSid  ConvertSidToStringSidA
  167. #endif // !UNICODE
  168.  
  169. WINADVAPI
  170. BOOL
  171. WINAPI
  172. ConvertStringSidToSidA(
  173.     IN LPCSTR   StringSid,
  174.     OUT PSID   *Sid
  175.     );
  176. WINADVAPI
  177. BOOL
  178. WINAPI
  179. ConvertStringSidToSidW(
  180.     IN LPCWSTR   StringSid,
  181.     OUT PSID   *Sid
  182.     );
  183. #ifdef UNICODE
  184. #define ConvertStringSidToSid  ConvertStringSidToSidW
  185. #else
  186. #define ConvertStringSidToSid  ConvertStringSidToSidA
  187. #endif // !UNICODE
  188.  
  189. WINADVAPI
  190. BOOL
  191. WINAPI
  192. ConvertStringSecurityDescriptorToSecurityDescriptorA(
  193.     IN  LPCSTR StringSecurityDescriptor,
  194.     IN  DWORD StringSDRevision,
  195.     OUT PSECURITY_DESCRIPTOR  *SecurityDescriptor,
  196.     OUT PULONG  SecurityDescriptorSize OPTIONAL
  197.     );
  198. WINADVAPI
  199. BOOL
  200. WINAPI
  201. ConvertStringSecurityDescriptorToSecurityDescriptorW(
  202.     IN  LPCWSTR StringSecurityDescriptor,
  203.     IN  DWORD StringSDRevision,
  204.     OUT PSECURITY_DESCRIPTOR  *SecurityDescriptor,
  205.     OUT PULONG  SecurityDescriptorSize OPTIONAL
  206.     );
  207. #ifdef UNICODE
  208. #define ConvertStringSecurityDescriptorToSecurityDescriptor  ConvertStringSecurityDescriptorToSecurityDescriptorW
  209. #else
  210. #define ConvertStringSecurityDescriptorToSecurityDescriptor  ConvertStringSecurityDescriptorToSecurityDescriptorA
  211. #endif // !UNICODE
  212.  
  213.  
  214. WINADVAPI
  215. BOOL
  216. WINAPI
  217. ConvertSecurityDescriptorToStringSecurityDescriptorA(
  218.     IN  PSECURITY_DESCRIPTOR  SecurityDescriptor,
  219.     IN  DWORD RequestedStringSDRevision,
  220.     IN  SECURITY_INFORMATION SecurityInformation,
  221.     OUT LPSTR  *StringSecurityDescriptor OPTIONAL,
  222.     OUT PULONG StringSecurityDescriptorLen OPTIONAL
  223.     );
  224. WINADVAPI
  225. BOOL
  226. WINAPI
  227. ConvertSecurityDescriptorToStringSecurityDescriptorW(
  228.     IN  PSECURITY_DESCRIPTOR  SecurityDescriptor,
  229.     IN  DWORD RequestedStringSDRevision,
  230.     IN  SECURITY_INFORMATION SecurityInformation,
  231.     OUT LPWSTR  *StringSecurityDescriptor OPTIONAL,
  232.     OUT PULONG StringSecurityDescriptorLen OPTIONAL
  233.     );
  234. #ifdef UNICODE
  235. #define ConvertSecurityDescriptorToStringSecurityDescriptor  ConvertSecurityDescriptorToStringSecurityDescriptorW
  236. #else
  237. #define ConvertSecurityDescriptorToStringSecurityDescriptor  ConvertSecurityDescriptorToStringSecurityDescriptorA
  238. #endif // !UNICODE
  239.  
  240. #endif /* _WIN32_WINNT >=  0x0500 */
  241.  
  242.  
  243. #ifdef __cplusplus
  244. }
  245. #endif
  246.  
  247. #pragma option pop /*P_O_Pop*/
  248. #endif  // endif __SDDL_H__
  249.  
  250.  
  251.