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.