Programming Guides › Programming Guide for Perl › CLI Policy Management Methods › Policy Methods › AllowNested Method—Sets or Retrieves the AllowNested Flag

AllowNested Method—Sets or Retrieves the AllowNested Flag

The AllowNested method sets or retrieves the AllowNested flag.

Syntax

The AllowNested method has the following format:

Netegrity::PolicyMgtPolicy‑>AllowNested(user[, iRecursiveFlag])

Parameters

The AllowNested method accepts the following parameters:

user (PolicyMgtUser)

Specifies the user for which to set or retrieve the AllowNested flag.

iRecursiveFlag (int)

(Optional) Specifies the value of the AllowNested flag:

• 1 for recursive evaluation
• 0 for non-recursive evaluation

If this is not passed, the function returns the current value of the AllowNested flag. The flag applies to all the users added to the policy for a particular user directory.

Return Value

The AllowNested method returns one of the following values:

• 0 if AllowNested flag is removed successfully.
• 1 if AllowNested flag is set successfully.
• -1 if the call is unsuccessful