Programming Guides › Programming Guide for Perl › CLI Policy Management Methods › Realm Methods › GetChildRealm Method—Retrieves a Top-level Child Realm under the Realm

GetChildRealm Method—Retrieves a Top-level Child Realm under the Realm

The GetChildRealm method retrieves a top-level child realm under the realm. This method only searches child realms.

Syntax

The GetChildRealm method has the following format:

Netegrity::PolicyMgtRealm‑>GetChildRealm(realmName)

Parameters

The GetChildRealm method accepts the following parameter:

realmName (string)

Specifies the realm to check for child realms.

Return Value

The GetChildRealm method returns one of the following values:

• A PolicyMgtRealm object
• undef if the call is unsuccessful, or if the realm does not exist