emsmdbp_object: emsmdbp_object_open_folder_by_fid() to return MAPISTATUS

And also handle different kinds of error properly in implementation.
enum mapistore_error is mapped to enum MAPISTATUS for instance