EXPORT-PRINCIPAL( ) method

Exports a sealed Client-principal object, with its currently defined property and attribute settings, by converting it to a raw value. You can assign this value to a RAW variable and send it to another client (such as the AppServer™). The receiving client can then import the raw value into another Client-principal object handle, using the IMPORT-PRINCIPAL( ) method, and use the imported object to set a user ID using either the SET-CLIENT( ) method or SET-DB-CLIENT function.

Return type: RAW

Applies to: Client-principal object handle

Syntax

EXPORT-PRINCIPAL( )

If the Client-principal object is in the initial (presealed) LOGOUT state, the AVM generates a run-time error.

Calling this method does not generate an audit event or an audit record.

The following code fragment illustrates how to use the EXPORT-PRINCIPAL( ) method:

DEFINE VARIABLE hCP    AS HANDLE NO-UNDO. DEFINE VARIABLE raw-cp AS RAW    NO-UNDO. . . . CREATE CLIENT-PRINCIPAL hCp. . . . raw-cp = hCP:EXPORT-PRINCIPAL( ).

See also: IMPORT-PRINCIPAL( ) method, SET-CLIENT( ) method, SET-DB-CLIENT function

OpenEdge Release 10.2B

Copyright © 2009 Progress Software Corporation