Reference Guide C API www.spreadconcepts.com


C API
Replicated Hash Table
Version 2.0


rht_error
  rht_code rht_error(rht r, rht_code *err_ptr, int flags);


Parameters
  r replica handle of replica being queried
  err_ptr error code of any permanent error on the replica
  flags RHT_DIRTY_READ (default) or RHT_CLEAN_READ


Return Values
  0 on success
  non-zero for error


Description
 

rht_error returns any permanent error that exists on a replica through err_ptr. A permanent error is an error from which the replica cannot recover. Most RHT calls (except for rht_fini) on the handle of such a replica will fail with the same permanent error code until rht_fini is called.

Use of the default RHT_DIRTY_READ flag will cause rht_error to return the error condition immediately without waiting for any locally generated updates to be applied. Whereas, specifying the RHT_CLEAN_READ will first apply all locally generated updates, and then return the error code.



Requirements
  Header: Declared in rht.h
Library: Use rht.lib
Version: 2.0


Also See
  RHT reference guide


Copyright © 2004, Spread Concepts LLC, All rights reserved