a0fa04fdcaaf8e6bb4e6fa122ca60af84270bcd3
[platform/upstream/krb5.git] / doc / html / _sources / appdev / refs / types / krb5_pre_send_fn.txt
1 .. highlightlang:: c
2
3 .. _krb5-pre-send-fn-struct:
4
5 krb5_pre_send_fn
6 ================
7
8 ..
9 .. c:type:: krb5_pre_send_fn
10 ..
11
12 Hook function for inspecting or modifying messages sent to KDCs.
13
14 If the hook function sets *reply_out* , *message* will not be sent to the KDC, and the given reply will used instead.
15 If the hook function sets *new_message_out* , the given message will be sent to the KDC in place of *message* .
16 If the hook function returns successfully without setting either output, *message* will be sent to the KDC normally.
17 The hook function should use :c:func:`krb5_copy_data()` to construct the value for *new_message_out* or *reply_out* , to ensure that it can be freed correctly by the library.
18
19 Declaration
20 ------------
21
22 typedef krb5_error_code( \* krb5_pre_send_fn)(krb5_context context, void \*data, const krb5_data \*realm, const krb5_data \*message, krb5_data \*\*new_message_out, krb5_data \*\*new_reply_out)
23
24