[akhaldi] 58507: [CRT] * Annotate mbctype.h.

Author: akhaldi
Date: Fri Mar 15 17:03:42 2013
New Revision: 58507

URL: http://svn.reactos.org/svn/reactos?rev=58507&view=rev
Log:
[CRT]
* Annotate mbctype.h.

Modified:
    trunk/reactos/include/crt/mbctype.h

Modified: trunk/reactos/include/crt/mbctype.h
URL:
http://svn.reactos.org/svn/reactos/trunk/reactos/include/crt/mbctype.h?rev=…
==============================================================================
--- trunk/reactos/include/crt/mbctype.h [iso-8859-1] (original)
+++ trunk/reactos/include/crt/mbctype.h [iso-8859-1] Fri Mar 15 17:03:42 2013
@@ -17,8 +17,8 @@
 #if 1
 #if defined (_DLL) && defined (_M_IX86)
   /* Retained for compatibility with VC++ 5.0 and earlier versions */
-  _CRTIMP unsigned char * __cdecl __p__mbctype(void);
-  _CRTIMP unsigned char * __cdecl __p__mbcasemap(void);
+  _Check_return_ _CRTIMP unsigned char * __cdecl __p__mbctype(void);
+  _Check_return_ _CRTIMP unsigned char * __cdecl __p__mbcasemap(void);
 #endif  /* defined (_DLL) && defined (_M_IX86) */
 #endif
 #ifndef _mbctype
@@ -70,40 +70,225 @@
 #ifndef _MBCTYPE_DEFINED
 #define _MBCTYPE_DEFINED
 
-  _CRTIMP int __cdecl _setmbcp(int _CodePage);
-  _CRTIMP int __cdecl _getmbcp(void);
-  _CRTIMP int __cdecl _ismbbkalnum(unsigned int _C);
-  _CRTIMP int __cdecl _ismbbkalnum_l(unsigned int _C,_locale_t _Locale);
-  _CRTIMP int __cdecl _ismbbkana(unsigned int _C);
-  _CRTIMP int __cdecl _ismbbkana_l(unsigned int _C,_locale_t _Locale);
-  _CRTIMP int __cdecl _ismbbkpunct(unsigned int _C);
-  _CRTIMP int __cdecl _ismbbkpunct_l(unsigned int _C,_locale_t _Locale);
-  _CRTIMP int __cdecl _ismbbkprint(unsigned int _C);
-  _CRTIMP int __cdecl _ismbbkprint_l(unsigned int _C,_locale_t _Locale);
-  _CRTIMP int __cdecl _ismbbalpha(unsigned int _C);
-  _CRTIMP int __cdecl _ismbbalpha_l(unsigned int _C,_locale_t _Locale);
-  _CRTIMP int __cdecl _ismbbpunct(unsigned int _C);
-  _CRTIMP int __cdecl _ismbbpunct_l(unsigned int _C,_locale_t _Locale);
-  _CRTIMP int __cdecl _ismbbalnum(unsigned int _C);
-  _CRTIMP int __cdecl _ismbbalnum_l(unsigned int _C,_locale_t _Locale);
-  _CRTIMP int __cdecl _ismbbprint(unsigned int _C);
-  _CRTIMP int __cdecl _ismbbprint_l(unsigned int _C,_locale_t _Locale);
-  _CRTIMP int __cdecl _ismbbgraph(unsigned int _C);
-  _CRTIMP int __cdecl _ismbbgraph_l(unsigned int _C,_locale_t _Locale);
+  _CRTIMP
+  int
+  __cdecl
+  _setmbcp(
+    _In_ int _CodePage);
+
+  _CRTIMP
+  int
+  __cdecl
+  _getmbcp(void);
+
+  _Check_return_
+  _CRTIMP
+  int
+  __cdecl
+  _ismbbkalnum(
+    _In_ unsigned int _C);
+
+  _Check_return_
+  _CRTIMP
+  int
+  __cdecl
+  _ismbbkalnum_l(
+    _In_ unsigned int _C,
+    _In_opt_ _locale_t _Locale);
+
+  _Check_return_
+  _CRTIMP
+  int
+  __cdecl
+  _ismbbkana(
+    _In_ unsigned int _C);
+
+  _Check_return_
+  _CRTIMP
+  int
+  __cdecl
+  _ismbbkana_l(
+    _In_ unsigned int _C,
+    _In_opt_ _locale_t _Locale);
+
+  _Check_return_
+  _CRTIMP
+  int
+  __cdecl
+  _ismbbkpunct(
+    _In_ unsigned int _C);
+
+  _Check_return_
+  _CRTIMP
+  int
+  __cdecl
+  _ismbbkpunct_l(
+    _In_ unsigned int _C,
+    _In_opt_ _locale_t _Locale);
+
+  _Check_return_
+  _CRTIMP
+  int
+  __cdecl
+  _ismbbkprint(
+    _In_ unsigned int _C);
+
+  _Check_return_
+  _CRTIMP
+  int
+  __cdecl
+  _ismbbkprint_l(
+    _In_ unsigned int _C,
+    _In_opt_ _locale_t _Locale);
+
+  _Check_return_
+  _CRTIMP
+  int
+  __cdecl
+  _ismbbalpha(
+    _In_ unsigned int _C);
+
+  _Check_return_
+  _CRTIMP
+  int
+  __cdecl
+  _ismbbalpha_l(
+    _In_ unsigned int _C,
+    _In_opt_ _locale_t _Locale);
+
+  _Check_return_
+  _CRTIMP
+  int
+  __cdecl
+  _ismbbpunct(
+    _In_ unsigned int _C);
+
+  _Check_return_
+  _CRTIMP
+  int
+  __cdecl
+  _ismbbpunct_l(
+    _In_ unsigned int _C,
+    _In_opt_ _locale_t _Locale);
+
+  _Check_return_
+  _CRTIMP
+  int
+  __cdecl
+  _ismbbalnum(
+    _In_ unsigned int _C);
+
+  _Check_return_
+  _CRTIMP
+  int
+  __cdecl
+  _ismbbalnum_l(
+    _In_ unsigned int _C,
+    _In_opt_ _locale_t _Locale);
+
+  _Check_return_
+  _CRTIMP
+  int
+  __cdecl
+  _ismbbprint(
+    _In_ unsigned int _C);
+
+  _Check_return_
+  _CRTIMP
+  int
+  __cdecl
+  _ismbbprint_l(
+    _In_ unsigned int _C,
+    _In_opt_ _locale_t _Locale);
+
+  _Check_return_
+  _CRTIMP
+  int
+  __cdecl
+  _ismbbgraph(
+    _In_ unsigned int _C);
+
+  _Check_return_
+  _CRTIMP
+  int
+  __cdecl
+  _ismbbgraph_l(
+    _In_ unsigned int _C,
+    _In_opt_ _locale_t _Locale);
+
 #ifndef _MBLEADTRAIL_DEFINED
 #define _MBLEADTRAIL_DEFINED
-  _CRTIMP int __cdecl _ismbblead(unsigned int _C);
-  _CRTIMP int __cdecl _ismbblead_l(unsigned int _C,_locale_t _Locale);
-  _CRTIMP int __cdecl _ismbbtrail(unsigned int _C);
-  _CRTIMP int __cdecl _ismbbtrail_l(unsigned int _C,_locale_t _Locale);
-  _CRTIMP int __cdecl _ismbslead(const unsigned char *_Str,const unsigned char *_Pos);
-  _CRTIMP int __cdecl _ismbslead_l(const unsigned char *_Str,const unsigned char
*_Pos,_locale_t _Locale);
-  _CRTIMP int __cdecl _ismbstrail(const unsigned char *_Str,const unsigned char *_Pos);
-  _CRTIMP int __cdecl _ismbstrail_l(const unsigned char *_Str,const unsigned char
*_Pos,_locale_t _Locale);
-#endif
-#endif
+
+  _Check_return_
+  _CRTIMP
+  int
+  __cdecl
+  _ismbblead(
+    _In_ unsigned int _C);
+
+  _Check_return_
+  _CRTIMP
+  int
+  __cdecl
+  _ismbblead_l(
+    _In_ unsigned int _C,
+    _In_opt_ _locale_t _Locale);
+
+  _Check_return_
+  _CRTIMP
+  int
+  __cdecl
+  _ismbbtrail(
+    _In_ unsigned int _C);
+
+  _Check_return_
+  _CRTIMP
+  int
+  __cdecl
+  _ismbbtrail_l(
+    _In_ unsigned int _C,
+    _In_opt_ _locale_t _Locale);
+
+  _Check_return_
+  _CRTIMP
+  int
+  __cdecl
+  _ismbslead(
+    _In_reads_z_(_Pos - _Str + 1) const unsigned char *_Str,
+    _In_z_ const unsigned char *_Pos);
+
+  _Check_return_
+  _CRTIMP
+  int
+  __cdecl
+  _ismbslead_l(
+    _In_reads_z_(_Pos - _Str + 1) const unsigned char *_Str,
+    _In_z_ const unsigned char *_Pos,
+    _In_opt_ _locale_t _Locale);
+
+  _Check_return_
+  _CRTIMP
+  int
+  __cdecl
+  _ismbstrail(
+    _In_reads_z_(_Pos - _Str + 1) const unsigned char *_Str,
+    _In_z_ const unsigned char *_Pos);
+
+  _Check_return_
+  _CRTIMP
+  int
+  __cdecl
+  _ismbstrail_l(
+    _In_reads_z_(_Pos - _Str + 1) const unsigned char *_Str,
+    _In_z_ const unsigned char *_Pos,
+    _In_opt_ _locale_t _Locale);
+
+#endif /* _MBLEADTRAIL_DEFINED */
+
+#endif /* _MBCTYPE_DEFINED */
 
 #ifdef __cplusplus
 }
 #endif
-#endif
+
+#endif /* _INC_MBCTYPE */