6 67 LceUnicodeToHex

LANSA Open Guide

6.67 LceUnicodeToHex

This function converts a Unicode string into a formatted stream of hex bytes to be used in the where clause.

int

LceUnicodeToHex

( wchar_t far *

strString,

 

 

char far *

strHexString,

 

 

int

iHexStringSize )

  

Parameters

 

 

strString

Unicode string to be converted. Should be null terminated.

strHexString

The generated stream of hex bytes.

iHexStringSize

The size of the strHexString buffer. The size of the buffer will normally be (( 4 * number of characters in strString ) + 5).

  

Return Values

If strHexString is NULL, then this function will return the size of the converted string (see Notes).

If strHexString is not NULL, the following is returned:

TRUE is returned if every character in the Unicode string has been converted without errors.

FALSE is returned if an error occurs or the buffer is not large enough to convert the entire string.

Notes

This function should be used when including a Unicode value in the where clause in LceRequestSelectWhere.

To determine the size of the buffer required to store the converted string you may call this function and pass NULL for the strHexString parameter. The function will not perform the conversion but will return the size of the buffer required for the conversion.

Related Functions

6.51 LceRequestSelectWhere