Security Administration (ISecurityAdmin Interface)

GetAccessControlTemplatesOnObj

Lists the ACTs that are associated with a resource.

Category: General authorization administration methods

GetAccessControlTemplatesOnObj(tCtxt,resource,flags,ACT_list);

Parameters

Parameter	Type	Direction	Description
tCtxt	string	in	Optional handle representing a server-side transaction context.
resource	string	in	Passed resource identifier for the object for which ACTs are requested. If TCTXT is used, do not specify a value in RESOURCE.
flags	int	in	Currently unused. Callers should set this parameter to 0.
ACT_list	string array	out	Returned two-dimensional string array with three columns. Each row in the array represents an ACT. See the "Details" section for more information. Column 0: Contains the ACT metadata object identifier. Column 1: Contains the ACT Name= value. Column 2: Contains the ACT Description= value.

Details

The GetAccessControlTemplatesOnObj method returns ACT_LIST when TCTXT or RESOURCE is specified, even if there are no ACTs (an empty list is returned).

When TCTXT is specified and previous calls to the ApplyACTToObj or RemoveACTFromObj method on this TCTXT modified the list of ACTs protecting the resource, then the modified list is returned. Until the EndTransactionContext method is executed on the TCTXT with SECAD_COMMIT_TC, the content of ACT_LIST might not reflect the actual ACTs currently protecting the resource.

When RESOURCE is specified in the GetAccessControlTemplatesOnObj method, then ACT_LIST returns the actual ACTs protecting the resource.

Exceptions Thrown

The SAS Open Metadata Interface explicitly returns the following exceptions for the GetAccessControlTemplatesOnObj method:

SECAD_INVALID_TC_HANDLE
SECAD_INVALID_RESOURCE_SPEC
SECAD_INVALID_ACTION
SECAD_NOT_AUTHORIZED

Related Methods

Top of Page