Multibytetowidechar windows ce

If the first element of the array is 0x, the system uses the predefined dialog box class for the dialog box and the array has no other elements. If the first element is 0xFFFF, the array has one additional element that specifies the ordinal value of a predefined system window class.

If the first element has any other value, the system treats the array as a null-terminated Unicode string that specifies the name of a registered window class. Following the class array is a title array that specifies a null-terminated Unicode string that contains the title of the dialog box. If the first element of this array is 0x, the dialog box has no title and the array has no other elements.

The point size value specifies the point size of the font to use for the text in the dialog box and its controls. The typeface array is a null-terminated Unicode string specifying the name of the typeface for the font.

If you specify character strings in the class, title, or typeface arrays, you must use Unicode strings. The x , y , cx , and cy members specify values in dialog box units. You can convert these values to screen units pixels by using the MapDialogRect function. Send Feedback on this topic to the authors. Flags indicating the conversion type. Windows with SP4 and later, Windows XP: If this flag is not set, the function silently drops illegal code points.

For the code pages listed below, dwFlags must be set to 0. Size, in bytes, of the string indicated by the lpMultiByteStr parameter.

Alternatively, this parameter can be set to -1 if the string is null-terminated. Note that, if cbMultiByte is 0, the function fails. If this parameter is -1, the function processes the entire input string, including the terminating null character. Therefore, the resulting Unicode string has a terminating null character, and the length returned by the function includes this character.

If this parameter is set to a positive integer, the function processes exactly the specified number of bytes. If the provided size does not include a terminating null character, the resulting Unicode string is not null-terminated, and the returned length does not include this character. Size, in characters, of the buffer indicated by lpWideCharStr.

If this value is 0, the function returns the required buffer size, in characters, including any terminating null character, and makes no use of the lpWideCharStr buffer. Returns the number of characters written to the buffer indicated by lpWideCharStr if successful.

If the function succeeds and cchWideChar is 0, the return value is the required size, in characters, for the buffer indicated by lpWideCharStr. The function returns 0 if it does not succeed. To get extended error information, the application can call GetLastError , which can return one of the following error codes:. The default behavior of this function is to translate to a precomposed form of the input character string. If a precomposed form does not exist, the function attempts to translate to a composite form.

NormalizeString provides more accurate, standard, and consistent data, and can also be faster. As mentioned in the caution above, the output buffer can easily be overrun if this function is not first called with cchWideChar set to 0 in order to obtain the required size. You can also specify one of the following values:. The function performs more quickly when none of these flags is set. The following flag constants are defined:. A composite character consists of a base character and a nonspacing character, each having different character values.

If this value is —1, the string is assumed to be null-terminated and the length is calculated automatically. If this value is zero, the function returns the number of bytes required for the buffer.

In this case, the lpMultiByteStr buffer is not used. If this parameter is NULL, a system default value is used. The flag is set to TRUE if one or more wide characters in the source string cannot be represented in the specified code page.