Open topic with navigation

TIBCO iProcess® Engine 11.10.0

# 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.

Did you find this helpful?

Yes No
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

TIBCO iProcess® Engine

Copyright © 1994-2025. Cloud Software Group, Inc. All Rights Reserved.