[CRT]

* Annotate search.h.

svn path=/trunk/; revision=59817

diff --git a/reactos/include/crt/search.h b/reactos/include/crt/search.h
index 1f487bf..6fddba8 100644 (file)
--- a/reactos/include/crt/search.h
+++ b/reactos/include/crt/search.h
@@ -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 @@ extern "C" {
 
 #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 @@ extern "C" {
 
 #include <sec_api/search_s.h>
 
-#endif
+#endif /*_INC_SEARCH */