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