Try OpenEdge Now
skip to main content
Programming Interfaces
HLC Library Function Reference : Function reference : prordbc( ) - Read CHARACTER Field
 

prordbc( ) - Read CHARACTER Field

The prordbc( ) function reads the value of a CHARACTER field in a shared buffer.
On successful completion, prordbc( ) returns 0; otherwise, it returns a non-zero value:

Syntax

int
prordbc ( pbufnam, fhandle, index, pvar, punknown, varlen,
pactlen )
char *pbufnam;
int fhandle;
int index;
char *pvar;
int *punknown;
int varlen;
int *pactlen;
pbufnam
This input parameter points to the name of the specified shared buffer. You supply the name from your OpenEdge application.
fhandle
This input parameter is the field handle that profldix( ) returns for the specified field.
index
This input parameter specifies an index value for an array field. If the field is not an array, you must set the value of index to 0.
pvar
This output parameter points to a buffer where prordbc( ) returns the value of the specified CHARACTER field.
punknown
This output parameter points to an integer where prordbc( ) returns 1 if the field has the Unknown value (?), and returns 0 otherwise.
varlen
This input parameter contains the length of the buffer that pvar specifies.
pactlen
This output parameter points to an integer where prordbc( ) returns the actual length (in bytes) of the data in the specified CHARACTER field.
See Also:
profldix( ) - Return Field Handle, prordbd( ) - Read DATE Field, prordbi( ) - Read INTEGER Field, prordbl( ) - Read LOGICAL Field, prordbn( ) - Read DECIMAL Field, prordbr( ) - Read RECID Field, prowtbc( ) - Write CHARACTER Field