From 4a50829ceb6ffba77252610c577df98027d244ec Mon Sep 17 00:00:00 2001 From: Ken Raeburn Date: Thu, 29 Jun 2006 00:03:36 +0000 Subject: 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 --- src/include/krb5/krb5.hin | 18 +++++++++++++----- 1 file changed, 13 insertions(+), 5 deletions(-) (limited to 'src/include') 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); -- cgit