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

prordc( ) - Read CHARACTER Variable

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

Syntax

int
prordc ( psymnam, index, pvar, punknown, varlen, pactlen )
char *psymnam;
int index;
char *pvar;
int *punknown;
int varlen;
int *pactlen;
psymnam
This input parameter points to the name of the specified shared CHARACTER variable. You supply the name from your OpenEdge application.
index
This input parameter specifies an index value for an array variable. If the variable is not an array, you must set the value of index to 0.
pvar
This output parameter points to a buffer where prordc( ) returns the value of the specified CHARACTER variable.
punknown
This output parameter points to an integer where prordc( ) returns 1 if the variable 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 prordc( ) returns the actual length (in bytes) of the data in the specified CHARACTER variable.
See Also:
prordd( ) - Read DATE Variable, prordi( ) - Read INTEGER Variable, prordl( ) - Read LOGICAL Variable, prordn( ) - Read DECIMAL Variable, prordr( ) - Read RECID Variable, prowtc( ) - Write CHARACTER Variable