Imported Upstream version 1.15.2
[platform/upstream/krb5.git] / doc / html / _sources / appdev / refs / api / krb5_responder_pkinit_get_challenge.txt
1 krb5_responder_pkinit_get_challenge -  Decode the KRB5_RESPONDER_QUESTION_PKINIT to a C struct. 
2 ================================================================================================
3
4 ..
5
6 .. c:function:: krb5_error_code krb5_responder_pkinit_get_challenge(krb5_context ctx, krb5_responder_context rctx, krb5_responder_pkinit_challenge ** chl_out)
7
8 ..
9
10
11 :param:
12
13                   **[in]** **ctx** - Library context
14
15                   **[in]** **rctx** - Responder context
16
17                   **[out]** **chl_out** - Challenge structure
18
19
20 ..
21
22
23
24 ..
25
26
27
28
29
30
31
32 A convenience function which parses the KRB5_RESPONDER_QUESTION_PKINIT question challenge data, making it available in native C. The main feature of this function is the ability to read the challenge without parsing the JSON.
33
34
35
36 The returned value must be passed to :c:func:`krb5_responder_pkinit_challenge_free()` to be freed.
37
38
39
40
41
42
43
44
45
46
47 ..
48
49
50
51
52 .. note::
53
54          New in 1.12
55  
56