uva_next_user_ex

Purpose

Returns the encrypted user and encrypted description buffer for the name and description of the first or subsequent VPIU.

Warning

You must use this interface instead of the uva_next_user 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_next_user_ex (
   UV_SH uvsh,                
   UV_FLAG fFirstUser 
   UV_PSTR pOSUserLocations,        
   UV_PSTR pEncrNameBuf,      
   UV_SIZE iNameBufSize,      
   UV_PSTR pEncrDescBuf,      
   UV_SIZE iDescBufSize       
);

Parameters

Parameter	Type	Description
uvsh	IN	Session handle
fFirstUser	IN	First/next VPIU flag
pOSUserLocations	IN	Value of the OS_USER_LOCATIONS process attribute.
pEncrNameBuf	OUT	Pointer to buffer to receive encrypted VPIU name
iNameBufSize	IN	Maximum length of encrypted VPIU name
pEncrDescBuf	OUT	Pointer to buffer to receive encrypted VPIU description
iDescBufSize	IN	Maximum length of encrypted VPIU description

Return Values

Value	Description
SW_OK	Success
SW_EOF	No more users available
ER_HANDLE	Invalid session handle
ER_PARAM	Invalid parameter(s)
ER_SYSTEM	Generic (undefined) error
ER_TOOBIG	Value is too large for supplied buffer

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

Remarks

This interface is an extended version of the uva_next_user interface. It differs from that interface only in the following ways:

•

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.

•

It has an additional pOSUserLocations parameter, which allows the value of the OS_USER_LOCATIONS process attribute to be passed in (for example, if you want to limit the users that are to be returned by the UVAPI layer). See the "Administering Process Attributes" section of TIBCO iProcess Engine Administrator’s Guide for more information about this attribute and how to set it.