GetAccessControlTemplatesOnObj

Short Description

Lists the ACTs that are associated with a resource.

Category

General authorization administration methods

Syntax

GetAccessControlTemplatesOnObj(tCtxt,resource,flags,ACT_list);

Parameters

Method 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 attribute value.
Column 2:
Contains the ACT Description attribute 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

Copyright © SAS Institute Inc. All rights reserved.