Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- db_VISTA III - d_csoset http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
   D_CSOSET

SUMMARY
   d_csoset(SET,dba[,dbn])
   int SET;
   DB_ADDR *dba;
   int dbn;

ARGUMENTS
   SET         Set type for the current owner to be assigned.

   dba         Pointer to the database address to become the current
               owner of SET.

   dbn         (optional) The number of the database containing the record.

DESCRIPTION
   Function d_csoset copies the database address pointed by dba to the
   current owner of SET. The current member of SET is made null.If dba
   is NULL_DBA, the current owner and current member of SET are made null.
   This function is used in conjunction with function d_csoget for saving
   and restoring the current owner of a set.

--------------------------------------------------------------------------
Note:
   If the record type of the current owner is timestamped, you should also
   call d_stsco to set the last access timestamp for the current owner.
--------------------------------------------------------------------------

CURRENCY CHANGES
   curr_own[SET]=*dba(or NULL_DBA if dba==NULL_DBA);
   curr_mem[SET]=NULL_DBA;

RETURN CODES
   -2    S_INVSET       Invalid set type. Probably passed a record or
                        field type instead of a set type.

   -6    S_INVADDR      Invalid database address.You may have passed
                        the database address itself rather than a
                        pointer to it.

  -18    S_INVOWN       Record associated with dba is not a valid owner
                        of SET.

EXAMPLE
   DB_ADDR dba;
    ..
   /* save current author on stack for later processing */
   d_csoget(HAS_PUBLISHED,&dba);
    ..
   /* restore saved author as owner of has_published */
   d_csoset(HAS_PUBLISHED,&dba);
    ..

See Also: d_crget d_crset d_csmget d_csmset d_gtsco d_gtscr

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson