fix calling convention for krb5 error-message routines, document usage of krb5_get_error_message

* lib/krb5/krb/kerrs.c (krb5_*_error_message): Annotate with correct calling
conventions for Windows.
* include/krb5/krb5.hin: Update declarations.  Add comment on
krb5_get_error_message usage.

ticket: new
target_version: 1.5
tags: pullup

git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@18254 dc483132-0cff-0310-8789-dd5450dbe970

1 files changed, 13 insertions, 5 deletions

diff --git a/src/include/krb5/krb5.hin b/src/include/krb5/krb5.hin
index 9c8399847..ed896b5da 100644
--- a/src/include/krb5/krb5.hin
+++ b/src/include/krb5/krb5.hin
@@ -2539,17 +2539,25 @@ krb5_prompt_type* KRB5_CALLCONV krb5_get_prompt_types
 	(krb5_context context);
 
 /* Error reporting */
-void
+void KRB5_CALLCONV_C
 krb5_set_error_message (krb5_context, krb5_error_code, const char *, ...);
 #ifdef va_start
-void
+void KRB5_CALLCONV
 krb5_vset_error_message (krb5_context, krb5_error_code, const char *, va_list);
 #endif
-char *
+/* The behavior of krb5_get_error_message is only defined the first
+   time it is called after a failed call to a krb5 function using the
+   same context, and only when the error code passed in is the same as
+   that returned by the krb5 function.  Future versions may return the
+   same string for the second and following calls.
+
+   The string returned by this function must be freed using
+   krb5_free_error_message.  */
+char * KRB5_CALLCONV
 krb5_get_error_message (krb5_context, krb5_error_code);
-void
+void KRB5_CALLCONV
 krb5_free_error_message (krb5_context, char *);
-void
+void KRB5_CALLCONV
 krb5_clear_error_message (krb5_context);