Imported Upstream version 1.15.2
[platform/upstream/krb5.git] / doc / html / _sources / appdev / refs / types / krb5_post_recv_fn.txt
1 .. highlightlang:: c
2
3 .. _krb5-post-recv-fn-struct:
4
5 krb5_post_recv_fn
6 =================
7
8 ..
9 .. c:type:: krb5_post_recv_fn
10 ..
11
12 Hook function for inspecting or overriding KDC replies.
13
14 If *code* is non-zero, KDC communication failed and *reply* should be ignored. The hook function may return *code* or a different error code, or may synthesize a reply by setting *new_reply_out* and return successfully.
15 The hook function should use :c:func:`krb5_copy_data()` to construct the value for *new_reply_out* , to ensure that it can be freed correctly by the library.
16
17 Declaration
18 ------------
19
20 typedef krb5_error_code( \* krb5_post_recv_fn)(krb5_context context, void \*data, krb5_error_code code, const krb5_data \*realm, const krb5_data \*message, const krb5_data \*reply, krb5_data \*\*new_reply_out)
21
22