RHT Docs | C API

Reference Guide

C API

www.spreadconcepts.com

C API
Replicated Hash Table
Version 2.0

rht_create

rht_code rht_create(rht_options o, rht *r, rht_name *rpn);

Parameters

	o	Allows the user to specify information about the RHT to which they are connecting
	rpn	The unique name assigned to the the replicant in the replication system is copied to rpn if it is non-NULL
	r	returns its per-process unique replica handle through r

Return Values

	RHT_SUCCESS	Success
	RHT_ILLEGAL_DAEMON	The caller passed an invalid Spread daemon name.
	RHT_ILLEGAL_NAME	The caller passed an invalid RHT name or login name.
	RHT_CANT_COMMUNICATE	The specified Spread daemon refuses to communicate with this thread due to incompatibilities between its version and the version of the Spread client library that this process is using.
	RHT_NAME_EXISTS	The caller passed a login name that is already in use on the specified Spread daemon.

Description

rht_create creates a local replica of a specified rht. All subsequent operations on this replica must be made using the returned integer handle r. The parameter o allows the user to specify information about the RHT to which they are connecting.

On failure, no replica is created and no valid handle is returned through r.

A full description of the setting in the options parameter are defined here and a detailed discussion what they should be set to is described here.

Requirements

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

Also See

RHT reference guide