Bone Handles

Bone Handles are used to keep track of Bone connections.  A BONEHANDLE is created upon calling bone_create(), and it destroyed when the connection is destroyed.  It is important to note that BONEHANDLEs cannot be reused once a connection is lost.  You must create a new BONEHANDLE each time you attempt to connect to the BoneServer.  It is also important to note that three Bone API functions attempt to connect to the BoneServer.  These are bone_createuser(), bone_login(), and bone_reqpassword().  As a result, for example, if you call bone_createuser(), you cannot reuse the BONEHANDLE for bone_login().