| Platform SDK: MAPI |
CMC_string is a CMC data type that is a pointer to a character string.
| Header file: | XCMC.H |
typedef char *CMC_string;
By default, the CMC implementation interprets the string that this data type points to as a null-terminated array of characters. The chosen character set determines the width of a character and the corresponding null-terminating character.
If a client application uses counted strings instead of null-terminated strings, it must set the CMC_COUNTED_STRING_TYPE flag in the logon_flags parameter when logging onto a MAPI session through cmc_logon. The data pointed to by a string of type CMC_string is then defined as a CMC_counted_string structure.
To determine the character set of characters in the string, the CMC implementation looks at the character set in the session attributes, which are chosen by the client application when the call to cmc_logon is made. CMC always attempts to map all strings passed to the client application to the character set for the session. If the client application has not called cmc_logon and is using an implicit session, the CMC implementation interprets input strings by using its default character set.