home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the Windows Gam…ming Gurus (2nd Edition) / Disc2.iso / msdn_vcb / samples / vc98 / sdk / com / dcom / dcomperm / readme.txt < prev    next >
Text File  |  1996-07-19  |  6KB  |  185 lines
  1. DCOMPERM
  2. ========
  3.  
  4. The DCOMPERM sample provides source code and several wrapper functions to
  5. simplify the process of manipulating the access and launch permissions for
  6. a COM server. Additionally, this sample provides code which demonstrates how
  7. to set and retrieve the RunAs password for a COM server.
  8.  
  9. Wrapper Functions
  10. -----------------
  11.  
  12. ChangeDefaultAccessACL ------------------------------------------------------
  13.  
  14. DWORD
  15. ChangeDefaultAccessACL (
  16.     LPTSTR Principal,
  17.     BOOL SetPrincipal,
  18.     BOOL Permit
  19.     );
  20.  
  21. Description:
  22.  
  23. Modify the default access access control list. The system uses the default
  24. access ACL to determine if a principal is allowed to access the COM server
  25. if the COM server does not have its own access ACL in the AppID section of
  26. the registry.
  27.  
  28. Parameters:
  29.  
  30.     Principal               Name of user or group (e.g. "redmond\johndoe")
  31.  
  32.     SetPrincipal            TRUE if you want to add/update the principal's
  33.                             entry in the ACL
  34.                             FALSE if you want to remove the principal from
  35.                             the ACL
  36.  
  37.     Permit                  TRUE if you want to allow the principal to access
  38.                             the object
  39.                             FALSE if you want to prevent the principal from
  40.                             accessing the object
  41.  
  42.     (Note that the Permit flag applies only when SetPrincipal is TRUE.)
  43.  
  44. ChangeAppIDAccessACL --------------------------------------------------------
  45.  
  46. DWORD
  47. ChangeAppIDAccessACL (
  48.     LPTSTR AppID,
  49.     LPTSTR Principal,
  50.     BOOL SetPrincipal,
  51.     BOOL Permit
  52.     );
  53.  
  54. Modify an AppID's access access control list. The system uses the AppID
  55. access ACL to determine if a principal is allowed to access the COM server
  56. associated with the AppID.
  57.  
  58. Parameters:
  59.     AppID                   The Application ID you wish to modify
  60.                             (e.g. "{99999999-9999-9999-9999-00AA00BBF7C7}")
  61.  
  62.     Principal               Name of user or group (e.g. "redmond\johndoe")
  63.  
  64.     SetPrincipal            TRUE if you want to add the principal to the ACL
  65.                             FALSE if you want to remove the principal from
  66.                             the ACL
  67.  
  68.     Permit                  TRUE if you want to allow the principal to access
  69.                             the object
  70.                             FALSE if you want to prevent the principal from
  71.                             accessing the object
  72.  
  73.  
  74.     (Note that the Permit flag applies only when SetPrincipal is TRUE.)
  75.  
  76. ChangeDefaultLaunchACL ------------------------------------------------------
  77.  
  78. DWORD
  79. ChangeDefaultLaunchACL (
  80.     LPTSTR Principal,
  81.     BOOL SetPrincipal,
  82.     BOOL Permit
  83.     );
  84.  
  85. Modify the default launch access control list. The system uses the
  86. default launch ACL to determine if a principal is allowed to launch a
  87. COM server if the COM server does not have its own launch ACL in the AppID
  88. section of the registry.
  89.  
  90. Parameters:
  91.  
  92.     Principal               Name of user or group (e.g. "redmond\johndoe")
  93.  
  94.     SetPrincipal            TRUE if you want to add/update the principal's
  95.                             entry in the ACL
  96.                             FALSE if you want to remove the principal from
  97.                             the ACL
  98.  
  99.     Permit                  TRUE if you want to allow the principal to launch
  100.                             the object
  101.                             FALSE if you want to prevent the principal from
  102.                             launching the object
  103.  
  104.     (Note that the Permit flag applies only when SetPrincipal is TRUE.)
  105.  
  106. ChangeAppIDLaunchACL --------------------------------------------------------
  107.  
  108. DWORD
  109. ChangeAppIDLaunchACL (
  110.     LPTSTR AppID,
  111.     LPTSTR Principal,
  112.     BOOL SetPrincipal,
  113.     BOOL Permit
  114.     );
  115.  
  116. Modify an AppID's launch access control list. The system uses the AppID
  117. launch ACL to determine if a principal (a user or group of users) is allowed
  118. to launch the COM server associated with the AppID.
  119.  
  120. Parameters:
  121.     AppID                   The Application ID you set permissions for
  122.                             (e.g. "{99999999-9999-9999-9999-00AA00BBF7C7}")
  123.  
  124.     Principal               Name of user or group (e.g. "redmond\johndoe")
  125.  
  126.     SetPrincipal            TRUE if you want to add the principal to the ACL
  127.                             FALSE if you want to remove the principal from
  128.                             the ACL
  129.  
  130.     Permit                  TRUE if you want to allow the principal to launch
  131.                             the object
  132.                             FALSE if you want to prevent the principal from
  133.                             launching the object
  134.  
  135.  
  136.     (Note that the Permit flag applies only when SetPrincipal is TRUE.)
  137.  
  138. GetRunAsPassword ------------------------------------------------------------
  139.  
  140. DWORD GetRunAsPassword (
  141.     LPTSTR AppID,
  142.     LPTSTR Password
  143.     );
  144.  
  145. Description:
  146.  
  147. Retrieves the RunAs password for an AppID.
  148.  
  149. Parameters:
  150.  
  151.     AppID                   The Application ID you wish to configure
  152.                             (e.g. "{99999999-9999-9999-9999-00AA00BBF7C7}")
  153.  
  154.     Password                Password of the user you have specified in
  155.                             the RunAs named value under the AppID registry
  156.                             key.
  157.  
  158. SetRunAsPassword ------------------------------------------------------------
  159.  
  160. DWORD SetRunAsPassword (
  161.     LPTSTR AppID,
  162.     LPTSTR Principal,
  163.     LPTSTR Password
  164.     );
  165.  
  166. Description:
  167.  
  168. Sets the RunAs password for an AppID. Note that if you have specified the
  169. RunAs named value to "Interactive User" you do not need to set the RunAs
  170. password.
  171.  
  172. Parameters:
  173.  
  174.     AppID                   The Application ID you wish to configure
  175.                             (e.g. "{99999999-9999-9999-9999-00AA00BBF7C7}")
  176.  
  177.     Principal            Name of the principal you have specified in the
  178.                 RunAs named value under the AppID registry key
  179.  
  180.     Password                Password of the principal you have specified in
  181.                             the RunAs named value under the AppID registry
  182.                             key.
  183.  
  184.  
  185.