4.3.91 ctdbFindTarget

---

Find a record using a target key.

Declaration

CTDBRET ctdbFindTarget(CTHANDLE Handle, pVOID target,

CTFIND_MODE FindMode)

Description

ctdbFindTarget finds a record with a given target key. Use ctdbFindRecord to find a record with the FindMode strategy.

Handle [in] the record handle.
target [in] string with the key target to lookup in the table.
FindMode [in] the mode to use to look for the record in the table. The find modes are listed in Section 4.1 "c-treeDB definitions" on page 4-1.

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

Note: Keep in mind that the key target in FindTarget must not be transformed. When using functions such as TransformKey or BuildTargetKey, you must supress the transfor- mation of the already-transformed key. In order to do this, you may define a macro NOTRANSFORM with a valueof 0x1000 and OR it into the mode passed to FindTar- get.

Returns

ctdbFindTarget returns CTDBRET_OK if the record was found, or c-treeDB C API error on failure.

See also

ctdbAllocRecord, ctdbFindRecord