home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the Windows Gam…ming Gurus (2nd Edition) / Disc2.iso / msdn_vcb / samples / vc98 / sdk / winbase / security / winnt / aclapi / readme.txt < prev   
Encoding:
Text File  |  1996-07-22  |  1.1 KB  |  38 lines
  1.  
  2. This module illustrates new Acl management API for Windows NT 4.0.
  3.  
  4. Developers of new software which is to run on Windows NT version 4.0
  5. and above are encouraged to utilize these security API rather than
  6. implementing code which uses lower level security API.  The development
  7. and test time can be drastically reduced by utilizing these new API.
  8.  
  9. This sample illustrates this point by implementing code which modifies
  10. the security on an existing file using the new Windows NT 4.0
  11. Acl management API.
  12.  
  13.  
  14. The following new API functions are illustrated in this sample:
  15.  
  16. GetNamedSecurityInfo()
  17. BuildExplicitAccessWithName()
  18. SetEntriesInAcl()
  19. SetNamedSecurityInfo()
  20.  
  21. The following lower-level security API would have been used to achieve
  22. the same result:
  23.  
  24. LookupAccountName()
  25. InitializeSecurityDescriptor()
  26. InitializeAcl()
  27. GetSecurityDescriptorDacl()
  28. GetAclInformation()
  29. GetAce()
  30. SetSecurityDescriptorDacl()
  31. AddAce()
  32. AddAccessAllowedAce() / AddAccessDeniedAce()
  33. GetFileSecurity()
  34. SetFileSecurity()
  35.  
  36. Less code and less complex code is required to achieve this task using
  37. the new Windows NT 4.0 Acl management API.
  38.