Release 10.1A: OpenEdge Development:
Progress 4GL Reference

> ## IMPORT-PRINCIPAL( ) method

> Imports a sealed Client-principal object, from its raw data form, and assigns it to a Client-principal object handle. The receiving Client-principal object handle assumes the property and attribute settings defined in the source object when it was exported using the EXPORT-PRINCIPAL( ) method.

> Return type: LOGICAL

> Applies to: Client-principal object handle

> Syntax
>     IMPORT-PRINCIPAL( expression )

> ``expression``

> A RAW expression containing the Client-principal object data to import. If the specified expression has the Unknown value (`?`), Progress generates a run-time error.

> The receiving Client-principal object must be unsealed. If not, Progress generates a run-time error.

> If you set properties on the receiving Client-principal object handle before calling this method, either by having previously imported the object or by setting them individually, the property values are lost.

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

> You can use the imported Client-principal object to set a user ID using either the SET-CLIENT( ) method or SET-DB-CLIENT function.

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

> Example

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

>     DEF VAR hCP as HANDLE.
>     DEF VAR raw-cp as RAW.
>     .
>     .
>     .
>     CREATE CLIENT-PRINCIPAL hCP.
>     .
>     .
>     .
>     hCP:IMPORT-PRINCIPAL(raw-cp).

> #### See also

> EXPORT-PRINCIPAL( ) method, SET-CLIENT( ) method, SET-DB-CLIENT function

Copyright © 2005 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095