[akhaldi] 59817: [CRT] * Annotate search.h.

Author: akhaldi
Date: Sun Aug 25 12:53:12 2013
New Revision: 59817

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

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

Modified: trunk/reactos/include/crt/search.h
URL:
http://svn.reactos.org/svn/reactos/trunk/reactos/include/crt/search.h?rev=5…
==============================================================================
--- trunk/reactos/include/crt/search.h	[iso-8859-1] (original)
+++ trunk/reactos/include/crt/search.h	[iso-8859-1] Sun Aug 25 12:53:12 2013
@@ -3,6 +3,7 @@
  * This file is part of the w64 mingw-runtime package.
  * No warranty is given; refer to the file DISCLAIMER within this package.
  */
+
 #ifndef _INC_SEARCH
 #define _INC_SEARCH
 
@@ -15,15 +16,73 @@
 
 #ifndef _CRT_ALGO_DEFINED
 #define _CRT_ALGO_DEFINED
-  void *__cdecl bsearch(const void *_Key,const void *_Base,size_t _NumOfElements,size_t
_SizeOfElements,int (__cdecl *_PtFuncCompare)(const void *,const void *));
-  void __cdecl qsort(void *_Base,size_t _NumOfElements,size_t _SizeOfElements,int
(__cdecl *_PtFuncCompare)(const void *,const void *));
+
+  _Check_return_
+  void *
+  __cdecl
+  bsearch(
+    _In_ const void *_Key,
+    _In_reads_bytes_(_NumOfElements * _SizeOfElements) const void *_Base,
+    _In_ size_t _NumOfElements,
+    _In_ size_t _SizeOfElements,
+    _In_ int(__cdecl *_PtFuncCompare)(const void *, const void *));
+
+  void
+  __cdecl
+  qsort(
+    _Inout_updates_bytes_(_NumOfElements * _SizeOfElements) void *_Base,
+    _In_ size_t _NumOfElements,
+    _In_ size_t _SizeOfElements,
+    _In_ int(__cdecl *_PtFuncCompare)(const void *, const void *));
+
 #endif
-  _CRTIMP void *__cdecl _lfind(const void *_Key,const void *_Base,unsigned int
*_NumOfElements,unsigned int _SizeOfElements,int (__cdecl *_PtFuncCompare)(const void
*,const void *));
-  _CRTIMP void *__cdecl _lsearch(const void *_Key,void *_Base,unsigned int
*_NumOfElements,unsigned int _SizeOfElements,int (__cdecl *_PtFuncCompare)(const void
*,const void *));
 
-#ifndef	NO_OLDNAMES
-  _CRTIMP void *__cdecl lfind(const void *_Key,const void *_Base,unsigned int
*_NumOfElements,unsigned int _SizeOfElements,int (__cdecl *_PtFuncCompare)(const void
*,const void *));
-  _CRTIMP void *__cdecl lsearch(const void *_Key,void *_Base,unsigned int
*_NumOfElements,unsigned int _SizeOfElements,int (__cdecl *_PtFuncCompare)(const void
*,const void *));
+  _Check_return_
+  _CRTIMP
+  void *
+  __cdecl
+  _lfind(
+    _In_ const void *_Key,
+    _In_reads_bytes_((*_NumOfElements) * _SizeOfElements) const void *_Base,
+    _Inout_ unsigned int *_NumOfElements,
+    _In_ unsigned int _SizeOfElements,
+    _In_ int(__cdecl *_PtFuncCompare)(const void *, const void *));
+
+  _Check_return_
+  _CRTIMP
+  void *
+  __cdecl
+  _lsearch(
+    _In_ const void *_Key,
+    _Inout_updates_bytes_((*_NumOfElements) * _SizeOfElements) void *_Base,
+    _Inout_ unsigned int *_NumOfElements,
+    _In_ unsigned int _SizeOfElements,
+    _In_ int(__cdecl *_PtFuncCompare)(const void *, const void *));
+
+#ifndef NO_OLDNAMES
+
+  _Check_return_
+  _CRTIMP
+  void *
+  __cdecl
+  lfind(
+    _In_ const void *_Key,
+    _In_reads_bytes_((*_NumOfElements) * _SizeOfElements) const void *_Base,
+    _Inout_ unsigned int *_NumOfElements,
+    _In_ unsigned int _SizeOfElements,
+    _In_ int(__cdecl *_PtFuncCompare)(const void *, const void *));
+
+  _Check_return_
+  _CRTIMP
+  void *
+  __cdecl
+  lsearch(
+    _In_ const void *_Key,
+    _Inout_updates_bytes_((*_NumOfElements) * _SizeOfElements) void *_Base,
+    _Inout_ unsigned int *_NumOfElements,
+    _In_ unsigned int _SizeOfElements,
+    _In_ int(__cdecl *_PtFuncCompare)(const void *, const void *));
+
 #endif
 
 #ifdef __cplusplus
@@ -32,4 +91,4 @@
 
 #include <sec_api/search_s.h>
 
-#endif
+#endif /*_INC_SEARCH */