To use the functions in library form or inline

Using Strsafe.h

• To use the Strsafe functions inline, include the header file as shown here, following the #include statements for all other header files.

  #include <strsafe.h>

• To use the functions in library form, include the following statement before including Strsafe.h. However, it is recommended that you use the inline functions.

  #define STRSAFE_LIB

   备注

  : The following functions must be used as inline functions: StringCbGets, StringCbGetsEx, StringCchGets, and StringCchGetsEx.

   

• When you include Strsafe.h in your file, the older functions replaced by the Strsafe.h functions will be deprecated. Attempts to use these older functions will result in a compiler error telling you to use the newer functions. If you want to override this behavior, include the following statement before including Strsafe.h.

  #define STRSAFE_NO_DEPRECATE

• To allow only character count functions, include the following statement before including Strsafe.h.

  #define STRSAFE_NO_CB_FUNCTIONS

• To allow only byte count functions, include the following statement before including Strsafe.h.

  #define STRSAFE_NO_CCH_FUNCTIONS

   备注

  You can define STRSAFE_NO_CB_FUNCTIONS or STRSAFE_NO_CCH_FUNCTIONS, but not both.

   

• Some Strsafe functions have locale-aware versions. By default, the header does not declare these functions. To enable these declarations, include the following macro statement before including Strsafe.h.

  #define STRSAFE_LOCALE_FUNCTIONS

• The maximum supported string length is 2,147,483,647 (STRSAFE_MAX_CCH) characters, either ANSI or Unicode.