Using Strsafe.h (Windows Embedded CE 6.0)
1/5/2010
To use the Strsafe functions inline, include the header file as shown here.
#include <strsafe.h>
Important
The include line for strsafe.h should follow all other headers' include lines.
To use the functions in library form, define STRSAFE_LIB before including the new header file, as shown below, and then add a link in your project to $(SDK_LIB_PATH)\strsafe.lib.
#define STRSAFE_LIB
#include <strsafe.h>
Note
StringCbGets, StringCbGetsEx, StringCchGets, and StringCchGetsEx must be run as inline functions.
When you include Strsafe.h in your file, the older functions replaced by the Strsafe.h functions are deprecated.
Attempts to use these older functions result in a compiler error telling you to use the newer functions. To override this behavior, include the following line in your code before including the Strsafe header file.
#define STRSAFE_NO_DEPRECATE
To allow only character count functions, include the following line in your code before including the Strsafe header file.
#define STRSAFE_NO_CB_FUNCTIONS
To allow only byte count functions, include the following line in your code before including the Strsafe header file.
#define STRSAFE_NO_CCH_FUNCTIONS
Note
You can define STRSAFE_NO_CB_FUNCTIONS or STRSAFE_NO_CCH_FUNCTIONS, but not both.
The maximum supported string length is 2,147,483,647 (STRSAFE_MAX_CCH) characters, either ANSI or Unicode.
See Also
Reference
StrSafe.h Character-Count Functions
StrSafe.h Byte-Count Functions