LOAD-DOMAINS( ) method

Loads registered authentication domains from the specified OpenEdge database into the application’s trusted authentication domain registry. The AVM uses this registry to validate Client-principal objects for the application during the session. After loading the registered domains, the AVM automatically restricts the registration of additional domains for the remainder of the session.

Note: Using this method to load registered authentication domains directly from an OpenEdge database provides more security than using the REGISTER-DOMAIN( ) and LOCK-REGISTRATION( ) methods because it automatically locks the registry.

Return type: LOGICAL

Applies to: SECURITY-POLICY system handle

Syntax

LOAD-DOMAINS( integer-expression | logical-name | alias )

integer-expression

The sequence number of a connected database from which to load registered domains. For example, LOAD-DOMAINS(1) loads registered domains from the first database, LOAD-DOMAINS(2) loads registered domains from the second database, and so on. If you specify a sequence number that does not correspond to a connected database, the AVM generates a run-time error.

logical-name or alias

The logical name or alias of a connected database from which to load registered domains. These forms require a quoted character string or a character expression. If you specify a logical name or alias that does not correspond to a connected database, the AVM generates a run-time error.

You can call this method only once per session.

If successful, this method returns TRUE. Otherwise, it returns FALSE.

See also: LOCK-REGISTRATION( ) method, REGISTER-DOMAIN( ) method

OpenEdge Release 10.2B

Copyright © 2009 Progress Software Corporation