uva_next_user

Purpose

Returns the encrypted user and encrypted description buffer for the name and description of the first or subsequent Valid Possible iProcess User (VPIU).

Warning

You must use the uva_next_user_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_next_user (
   UV_SH uvsh,                
   UV_FLAG fFirstUser         
   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
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 used by iProcess to obtain a list of possible iProcess users (currently used in the operating system user list of the TIBCO iProcess Administrator).

On the initial call to this interface the fFirstUser parameter should be set to TRUE (to return the first VPIU), subsequent calls should set fFirstUser to FALSE. The order in which VPIUs are returned by this interface is defined by the implementation of the underlying UVAPI package so the caller should assume no specific order.