EssDeleteUserEx

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);
ParameterData TypeDescription

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

  • EssDeleteGroupEx