Programming Guides › Programming Guide for Perl › CLI Policy Management Methods › Data Management Methods › OverwriteObjects Method—Sets or Retrieves the Overwrite Objects Flag

OverwriteObjects Method—Sets or Retrieves the Overwrite Objects Flag

The OverwriteObjects method sets or retrieves the overwrite objects flag.

Syntax

The OverwriteObjects method has the following format:

Netegrity::PolicyMgtDataMgr‑>OverwriteObjects([overwriteFlag])

Parameters

The OverwriteObjects method accepts the following parameter:

overwriteFlag (int)

(Optional) Specifies whether to allow existing objects to be overwritten:

• 1 allows existing objects to be overwritten
• 0 prevents existing objects from being overwritten

Return Value

The OverwriteObjects method returns one of the following values:

• The existing overwrite flag value (0 or 1) if no argument is specified
• The new overwrite flag value if an argument is passed to the method

Remarks

This flag determines whether existing objects should be overwritten during a call to the PolicyMgtDataMgr‑>Import method.

When you create a data manager object with the PolicyMgtSession‑>CreateDataManager method, this flag is initialized to 1 (overwrite existing objects).

To set the overwrite flag, call this method before calling the PolicyMgtDataMgr‑>Import method for the object. For a given instance of the data manager, a flag maintains its setting unless you reset it.