[akhaldi] 59661: [CRT] * Annotate time_s.h.

Author: akhaldi
Date: Tue Aug  6 21:34:25 2013
New Revision: 59661

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

Modified:
    trunk/reactos/include/crt/sec_api/time_s.h

Modified: trunk/reactos/include/crt/sec_api/time_s.h
URL: http://svn.reactos.org/svn/reactos/trunk/reactos/include/crt/sec_api/time_s....
==============================================================================
--- trunk/reactos/include/crt/sec_api/time_s.h	[iso-8859-1] (original)
+++ trunk/reactos/include/crt/sec_api/time_s.h	[iso-8859-1] Tue Aug  6 21:34:25 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 _TIME_H__S
 #define _TIME_H__S

@@ -14,22 +15,110 @@
 extern "C" {
 #endif

-  _CRTIMP errno_t __cdecl _ctime32_s(char *_Buf,size_t _SizeInBytes,const __time32_t *_Time);
-  _CRTIMP errno_t __cdecl _gmtime32_s(struct tm *_Tm,const __time32_t *_Time);
-  _CRTIMP errno_t __cdecl _localtime32_s(struct tm *_Tm,const __time32_t *_Time);
-  _CRTIMP errno_t __cdecl _strdate_s(char *_Buf,size_t _SizeInBytes);
-  _CRTIMP errno_t __cdecl _strtime_s(char *_Buf ,size_t _SizeInBytes);
-  _CRTIMP errno_t __cdecl _ctime64_s(char *_Buf,size_t _SizeInBytes,const __time64_t *_Time);
-  _CRTIMP errno_t __cdecl _gmtime64_s(struct tm *_Tm,const __time64_t *_Time);
-  _CRTIMP errno_t __cdecl _localtime64_s(struct tm *_Tm,const __time64_t *_Time);
+  _Success_(return == 0)
+  _CRTIMP
+  errno_t
+  __cdecl
+  _ctime32_s(
+    _Out_writes_(_SizeInBytes) _Post_readable_size_(26) char *_Buf,
+    _In_ size_t _SizeInBytes,
+    _In_ const __time32_t *_Time);
+
+  _Check_return_wat_
+  _CRTIMP
+  errno_t
+  __cdecl
+  _gmtime32_s(
+    _In_ struct tm *_Tm,
+    _In_ const __time32_t *_Time);
+
+  _CRTIMP
+  errno_t
+  __cdecl
+  _localtime32_s(
+    _Out_ struct tm *_Tm,
+    _In_ const __time32_t *_Time);
+
+  _Check_return_wat_
+  _CRTIMP
+  errno_t
+  __cdecl
+  _strdate_s(
+    _Out_writes_(_SizeInBytes) _Post_readable_size_(9) char *_Buf,
+    _In_range_(>= , 9) size_t _SizeInBytes);
+
+  _Check_return_wat_
+  _CRTIMP
+  errno_t
+  __cdecl
+  _strtime_s(
+    _Out_writes_(_SizeInBytes) _Post_readable_size_(9) char *_Buf,
+    _In_range_(>= , 9) size_t _SizeInBytes);
+
+  _CRTIMP
+  errno_t
+  __cdecl
+  _ctime64_s(
+    _Out_writes_z_(_SizeInBytes) char *_Buf,
+    _In_ size_t _SizeInBytes,
+    _In_ const __time64_t *_Time);
+
+  _CRTIMP
+  errno_t
+  __cdecl
+  _gmtime64_s(
+    _Out_ struct tm *_Tm,
+    _In_ const __time64_t *_Time);
+
+  _CRTIMP
+  errno_t
+  __cdecl
+  _localtime64_s(
+    _Out_ struct tm *_Tm,
+    _In_ const __time64_t *_Time);

#ifndef _WTIME_S_DEFINED
 #define _WTIME_S_DEFINED
-  _CRTIMP errno_t __cdecl _wasctime_s(wchar_t *_Buf,size_t _SizeInWords,const struct tm *_Tm);
-  _CRTIMP errno_t __cdecl _wctime32_s(wchar_t *_Buf,size_t _SizeInWords,const __time32_t *_Time);
-  _CRTIMP errno_t __cdecl _wstrdate_s(wchar_t *_Buf,size_t _SizeInWords);
-  _CRTIMP errno_t __cdecl _wstrtime_s(wchar_t *_Buf,size_t _SizeInWords);
-  _CRTIMP errno_t __cdecl _wctime64_s(wchar_t *_Buf,size_t _SizeInWords,const __time64_t *_Time);
+
+  _CRTIMP
+  errno_t
+  __cdecl
+  _wasctime_s(
+    _Out_writes_(_SizeInWords) _Post_readable_size_(26) wchar_t *_Buf,
+    _In_range_(>= , 26) size_t _SizeInWords,
+    _In_ const struct tm *_Tm);
+
+  _Success_(return == 0)
+  _CRTIMP
+  errno_t
+  __cdecl
+  _wctime32_s(
+    _Out_writes_(_SizeInWords) _Post_readable_size_(26) wchar_t *_Buf,
+    _In_ size_t _SizeInWords,
+    _In_ const __time32_t *_Time);
+
+  _CRTIMP
+  errno_t
+  __cdecl
+  _wstrdate_s(
+    _Out_writes_(_SizeInWords) _Post_readable_size_(9) wchar_t *_Buf,
+    _In_ size_t _SizeInWords);
+
+  _CRTIMP
+  errno_t
+  __cdecl
+  _wstrtime_s(
+    _Out_writes_(_SizeInWords) _Post_readable_size_(9) wchar_t *_Buf,
+    _In_range_(>= , 9) size_t _SizeInWords);
+
+  _Success_(return == 0)
+  _CRTIMP
+  errno_t
+  __cdecl
+  _wctime64_s(
+    _Out_writes_(_SizeInWords) _Post_readable_size_(26) wchar_t *_Buf,
+    _In_ size_t _SizeInWords,
+    _In_ const __time64_t *_Time);

#if !defined (RC_INVOKED) && !defined (_INC_WTIME_S_INL)
 #define _INC_WTIME_S_INL
@@ -38,7 +127,8 @@
 __CRT_INLINE errno_t __cdecl _wctime_s(wchar_t *_Buffer,size_t _SizeInWords,const time_t *_Time) { return _wctime64_s(_Buffer,_SizeInWords,_Time); }
 #endif
 #endif
-#endif
+
+#endif /* _WTIME_S_DEFINED */

#ifndef RC_INVOKED
 #ifdef _USE_32BIT_TIME_T
@@ -52,5 +142,6 @@
 }
 #endif

-#endif
-#endif
+#endif /* MINGW_HAS_SECURE_API */
+
+#endif /* _TIME_H__S */