locate

此函数使用由句柄引用的对象的元素值来定位树索引内部指针。

后续的 mco_cursor_next 和 mco_cursor_prev 操作将从索引中的此位置开始导航。此方法仅针对树索引游标生成。

    MCO_RET	classname_indexname_locate(	
    	/*IN*/ mco_trans_h trans, 
        /*INOUT*/ mco_cursor_h cursor, 
        /*IN*/ classname *handle
    );

参数

trans

mco_trans_h

由 mco_trans_start() 函数返回的事务句柄。

cursor

mco_cursor_h

通过 classname_indexname_index_cursor() 实例化的一个 mco_cursor_h 实例。

handle

classname

指向类名句柄的指针。

返回

MCO_S_OK

成功引用对象。

MCO_S_NOTFOUND

无法定位游标。

MCO_E_VOLUNTARY_NOT_EXIST

索引名称是自愿创建的，但尚未创建，或者已被删除。

MCO_ERR_CURSOR

游标操作中出现致命错误。