uva_set_user_identity_ex

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 this interface instead of the uva_set_user_identity 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_ex (
   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

This interface is an extended version of the uva_set_user_identity interface. It is identical to that interface except that it supports the passing in and out of user location information from the SW_DOMAIN user attribute and/or LOGON_OS_LOCATION process attribute. See Password Validation on Windows Systems for more information.