CNSAudit_Configure

Description

Calling this function with no parameters will open the CNS Audit Configuration Dialog. You can optionally open to a specific tab by specifying the name of the tab as the "Option" parameter. This function also allows you to get or set any preference found in the Configuration Dialog.

Valid PrefNames:

"AddHelp" - If True, Function specific Help will be added to Calculations when inserting the Plug-in's Functions.
"NoFullAccessAudit" - If True, the plug-in will not perform any Audits if the current user has [Full Access] privileges.

Return Type

Varies

Format

CNSAudit_Configure ( Option ; PrefName ; PrefValue )

Optional Parameters

• Option
  

  Specify the name of a Tab in the Configuration Dialog to show it opened to that tab.
  Specify "Get" with the PrefName parameter to get a preference value. (If not found, and PrefValue is defined, PrefValue will be returned.)
  Specify "Set" with the PrefName and PrefValue parameters to set a preference value.

• PrefName
  

  The Name of the Preference to Get or Set. (See the Function Description for a list of valid PrefNames.)

• PrefValue
  

  The Value of the Preference to Set. (See the Function Description for some possible values.)

Examples

Example 1

Code:

CNSAudit_Configure

Result:

Opens the CNS Audit Configuration Dialog. (Because the "Option" parameter is not used, the dialog will open to the "Basics" tab.)

Example 2

Code:

CNSAudit_Configure("About")

Result:

Opens the CNS Audit Configuration Dialog to the "About" tab.

Example 3

Code:

CNSAudit_Configure("Get";"NoFullAccessAudit")

Result:

Returns the value of the 'Disable Auditing for [Full Access] Users' setting from the Configuration Dialog.

Example 4

Code:

CNSAudit_Configure("Set";"NoFullAccessAudit";"True")

Result:

Sets the 'Disable Auditing for [Full Access] Users' setting in the Configuration Dialog to true.