C_SetNamedValue

Each OrcaFlex object maintains a table of integers, indexed by a user-specified name, which is intended for use by related external functions to co-ordinate their related working data. The integer type used, INT_PTR is pointer sized to enable you to store pointers in the table.

Note: These tables are cleared when OrcaFlex begins its statics calculation.

Call C_SetNamedValue to write to the table. Values can be read from the table by calling C_GetNamedValue.

void C_SetNamedValue(

TOrcFxAPIHandle ObjectHandle,

LPCTSTR lpName,

INT_PTR Value,

int *lpStatus

);

ObjectHandle (IN)

The handle of an object.

lpName (IN)

The name of the item in the table.

Value (IN)

The value to be written to the table.

lpStatus (OUT)

Points to a variable in which the status result for the function call will be returned.

Unicode and ANSI

The Unicode function name is C_SetNamedValueW and the ANSI function name is C_SetNamedValueA.

See also

C_GetCallerLong, C_GetNamedValue, C_SetCallerLong.