Sets a user information structure, which contains security information for the user.
Syntax
Declare Function EsbSetUserEx Lib "esbapin" (ByVal hCtx As Long, pUserInfo As ESB_USERINFOEX_T) As Long
Parameter | Description |
---|---|
hCtx | API context handle. |
pUserInfoEx | Pointer to info structure of externally authenticated user. |
Notes
This function operates similarly to EsbSetUser. The difference is that this function sets the extended user information structure ESB_USERINFOEX_T.
The name of the user to set is a field in the user info structure, which must always be specified.
The only fields in the user info structure which may be changed using this function are the Access, Expiration, and PwdChgNow fields (the other fields are for information only). For more information, see ESB_USERINFO_T, ESB_GROUPINFO_T.
The caller cannot give the specified user any access privileges that they themselves do not already have.
The new user settings will take effect the next time the user logs in.
Return Value
Returns zero (o) if successful.
Access
This function requires the caller to have Create/Delete User privilege (ESS_PRIV_USERCREATE) for the logged in server.