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.