uva_set_user_identity

Purpose

Sets the execution context of the current process to that of the user (or that user's operating system proxy) whose encrypted name is passed in. On UNIX this involves setting the UID and GID.

Warning

You must use the uva_set_user_identity_ex interface instead of this interface if you use the SW_DOMAIN or LOGON_OS_LOCATION attributes to specify the location where a user’s password should be validated. See Password Validation on Windows Systems for more information.

Prototype

UV_RCODE uva_set_user_identity (
   UV_SH uvsh, 
   UV_PSTR pEncrUserName 
);

Parameters

Parameter	Type	Description
uvsh	IN	Session handle
pEncrUserName	IN	Pointer to encrypted VPIU name

Return Values

Value	Description
SW_OK	Success
ER_NOTFOUND	Unknown user
ER_HANDLE	Invalid session handle
ER_PARAM	Invalid parameter(s)
ER_SYSTEM	Generic (undefined) error

See Return Values for a complete list of possible return values.

Remarks

If the user does not map directly to an operating system identity, the UVAPI package must set the identity of a compatible proxy user. iProcess calls this interface before running Automatic Step programs or ServerRun programs.