Programming Guides › Programming Guide for Perl › CLI Policy Management Methods › Trusted Host Methods › RolloverEnabled Method—Sets or Retrieves Shared Secret Rollover Flag

RolloverEnabled Method—Sets or Retrieves Shared Secret Rollover Flag

The RolloverEnabled method sets or retrieves the shared secret rollover flag that specifies whether shared secret rollover is enabled for this trusted host.

Syntax

The RolloverEnabled method has the following format:

Netegrity::PolicyMgtTrustedHost‑>RolloverEnabled([rolloverEnabled])

Parameters

The RolloverEnabled method accepts the following parameter:

rolloverEnabled (int)

(Optional) Specifies a new value for the shared secret rollover flag.

• value = 1

  Specifies that shared secret rollover is enabled for this trusted host.

• value = 0

  Specifies that shared secret rollover is not enabled for this trusted host.

Return Value

The RolloverEnabled method returns the new or existing value for the shared secret rollover flag:

• value = 1

  Specifies that shared secret rollover is enabled for this trusted host.

• value = 0

  Specifies that shared secret rollover is not enabled for this trusted host.

• undef

  Specifies that the call is unsuccessful.

Remarks

If shared secret rollover is enabled for this trusted host, it must also be enabled in the PolicyMgtSharedSecretPolicy object in the policy store domain where the trusted host is registered. If shared secret rollover is not enabled in this object, call the method PolicyMgtSharedSecretPolicy‑>Enabled to enable it.