mco_uda_oid_find

Search for the object with the specified oid.

Prototype

 
    MCO_RET mco_uda_oid_find(	/*IN*/ mco_trans_h t,
                   /*IN*/ mco_uda_value_t * id,  
                   /*OUT*/ */ mco_uda_object_handle_t * obj );
 

Arguments

t The transaction handle
id

Address of the mco_uda_value_tstructure containing the oid to search

obj

The address of a mco_uda_object_handle_t struct to receive the UDA object found

Description

Searches the database for the object with the specified oid.

Return Codes

MCO_S_OK The object with the specified oid was found
MCO_E_UDA_WRONG_VALUE_TYPE The id is not an oid or autooid value

MCO_S_NOTFOUND

No object found with this oid

Example

 
    Snippet from schema:
     
    struct oid_struct {
        uint4 id;
    };
     
    declare oid oid_struct[10000];
     
     
    Application snippet:
     
    int main(int argc, char** argv)
    {
        MCO_RET rc;
        mco_db_h db;
        mco_trans_h t;
        mco_uda_object_handle_t obj;
        oid an_oid;
        mco_uda_value_t val;
        ...
         
        an_oid.id = 1001;
        val.type     = MCO_DD_OID;
        val.v.p.p.v    = &an_oid;
        ...
        rc = mco_trans_start(db, MCO_READ_ONLY, MCO_TRANS_FOREGROUND, &t);
        if ( MCO_S_OK == rc )
        {
            rc = mco_uda_oid_find(t, &val, &obj);
        
            ...
            rc = mco_trans_rollback(t);
        }
    }
 

Files

Header file:
mcouda.h
Source file:
mcouda.c
Library:
libmcouda.a