6 59 LceSetFieldValueU

LANSA Open Guide

6.59 LceSetFieldValueU

Sets the field value in the field information area. This function should be used for Unicode fields. Unicode fields are field types NChar and NVarchar. This function is very important. It is used to assign values to fields in an information area, so that they may be used in other functions, such as LceFetch.

BOOL

LceSetFieldValue

(int

iSession,

 

 

char far *

strFieldName,

 

 

wchar_t far *

strValue )

  

Parameters

iSession

The session identifier as returned by LceGetSessionId.

strFieldName

The name of the field as used in the Repository. This field must have been declared using an LceUseField function.

strValue

The string which contains the value. The length of this parameter should not exceed RDMLX_FIELD_DATA_SIZE + 2 as defined in the LCOE.H header file. A NULL pointer indicates the value is *SQLNULL.

  

Return Values

TRUE is returned if the session has set the field value.

FALSE is returned if an error occurs.

Notes

See notes for LceSetFieldValue.

If this function is used with non-Unicode fields, it will automatically convert the value to an ascii value and call LceSetFieldValue.

  • This function may be executed at any time after the session is opened.
  • This function performs no communications to the host.

Related Functions

6.28 LceGetFieldValue

6.29 LceGetFieldValueX

6.18 LceGetDefaultValueU