Description
Allows non-administrators to change the e-mail address associated with their Bone account.

Callback
BONE_CALLBACK_CHANGEEMAIL

Notes
The function parameters are the BONEHANDLE and new e-mail address.  If successful (signified by BONE_CALLBACK_CHANGEEMAIL being called with errorcode 0 (BONE_OK) ), the BONEHANDLE is destroyed shortly after the function's callback is called.  Once the server verifies that your new e-mail address is not obviously invalid, it disconnects the client and e-mails a new password to the new e-mail address in order to verify the new e-mail address.  You must be extremely careful to make sure the e-mail address you call the function with is valid, or you will need to contact ImaBot to recover your account.

Example

bone_setcallback(BONE_CALLBACK_CHANGEEMAIL, callback_changeemail);

if (bone_changeemail(bnd,"bonester@imatowns.com"))
    printf("Unable to change e-mail (reason %d).\n",bone_getlasterror());
 
 

void callback_changeemail(BONEHANDLE bnd, int errorcode)
{
    if (errorcode)
    {
        printf("Error changing e-mail (reason: %d).",errorcode);
    }
}