CREATE CLIENT-PRINCIPAL statement

Creates an instance of a client-principal object at run time in the INITIAL state (see the LOGIN-STATE attribute entry). Each client-principal instance is a security token that contains user credentials specific to one user login session. This login session can be used to set the user identity for one or more ABL sessions, one or more database connections, or an entire ABL application. This user identity must be defined in a security domain that is registered in a trusted domain registry that is used to authenticate or validate that identity.

Note: You use a client-principal object with the SET-CLIENT( ) method or SET-DB-CLIENT function to set the user identity for an ABL session or OpenEdge database. You can set only one user identity at any one point in time for each ABL session or database connection. However, you can maintain multiple client-principal instances for any number of user identities that you need to set and maintain during an application.

Syntax

CREATE CLIENT-PRINCIPAL client-principal-handle
  [ IN WIDGET-POOL widget-pool-name]
client-principal-handle
A variable of type HANDLE that contains the handle to the client-principal object.
IN WIDGET-POOL widget-pool-name
An expression of type CHARACTER that evaluates, at run time, to the name of the widget pool in which the client-principal is created.
Note: Widget pool names are not case sensitive.

See also

Client-principal object handle, LOAD-DOMAINS( ) method, LOCK-REGISTRATION( ) method, REGISTER-DOMAIN( ) method, SET-CLIENT( ) method, SET-DB-CLIENT function