Deletes a user. Similar to EssDeleteUser, but can accept a user directory specification or unique identity attribute.
Syntax
ESS_FUNC_M EssDeleteUserEx (hCtx, UserId, bIsIdentity);
Parameter | Data Type | Description |
---|---|---|
hCtx | ESS_HCTX_T | Context handle (input). |
UserId | ESS_STR_T | Name of user to delete (input). Can be specified as username@provider or as a unique identity attribute. |
bIsIdentity | ESS_BOOL_T | Input. Indicates if UserId is a name or an identity. If TRUE, UserId is an identity. |
Notes
The caller may not delete itself nor the last Administrator on the server.
Return Value
None.
Access
This function requires the caller to have Create/Delete User privilege (ESS_PRIV_USERCREATE) for the logged in server.
Example
ESS_FUNC_M ESS_DeleteUserEx (ESS_HCTX_T hCtx) { ESS_FUNC_M sts = ESS_STS_NOERR; ESS_STR_T userId; ESS_BOOL_T bIsIdentity; userId = "IDUser3@ldap"; bIsIdentity = ESS_FALSE; sts = EssDeleteUserEx(hCtx, userId, bIsIdentity); printf("EssDeleteUserEx sts: %ld\n", sts); return (sts); }
See Also