rec_verify()

Purpose

To ensure a record is not updated by another user during the course of the current transaction and possible make addition checks, as for the function rec_post_with_flags()

Old name

#define verify rec_verify

Syntax (CCOWN)

void rec_verify(short *datarec, int flags)

Syntax (DP4DBAPI)

BOOLEAN dp4_rec_verify(DCONN * dconn,short * datarec,int flags);

Parameters

DCONN * dconn

Handle to database connection

short* datarec

Pointer to the L field of the database record to be checked

int flags

Specifies additional checks to be made

The parameter flags is the same as for the function rec_post_with_flags()

Description

This causes the same checking to be carried out on the specified record at commit time as would be done by the function rec_post_with_flags(), but the record is not posted to the database.

This function may be useful if you want to be sure that a record read, but not updated, during the course of a transaction has not changed when the record is committed. For example you might want to verify a record containing price information when creating a transaction line.

The DP4DBAPI version of this API returns TRUE if the function completes without errors. This does not indicate anything about the eventual success or failure of the transaction however.

See also

rec_post_with_flags(), db_commit()

Example

rec_verify(&order,NO_CHECK);