4.3.28 ctdbBuildTargetKey

---

Build a target key based on data in record buffer.

Declaration

CTDBRET ctdbBuildTargetKey(CTHANDLE Handle, CTFIND_MODE FindMode,

pVOID targetkey, pVRLEN targetlen)

Description

ctdbBuildTargetKey builds a target key based on data in record buffer.

Handle [in] the record handle.
FindMode [in] the find mode. Available values are found in Section 4.1 "c-treeDB definitions" on page 4-1.
targetkey [out] the target key.
targetlen [in/out] the target key length. Before calling ctdbBuildTargetKey set targetlen with the size of targetkey buffer.

Note: The FindMode CTFIND_EQ requires that the target contains values for all segments that compose the index and the index cannot allow duplicates.

Note: When using this function with the FindTarget function, you must supress the transfor- mation of the already-transformed key in FindTarget since it must not be transformed. In order to do this, you may define a macro NOTRANSFORM with a value of 0x1000 and OR it into the mode passed to FindTarget.

Returns

ctdbBuildTargetKey returns CTDBRET_OK on success, or c-treeDB C API error code on failure.