qkrb_parse_spnego_init_token()--Parse a SPNEGO Initiator Token
Syntax
#include <qkrbspnego.h> OM_uint32 qkrb_parse_spnego_init_token( gss_buffer_desc * init_token, qkrb_spnego_init_item_t ** parsed_token);Service Program Name: QSYS/QKRBSPNEGO
Default Public Authority: *USE
Threadsafe: Yes
The qkrb_parse_spnego_init_token() function parses a Simple and Protected GSS-API Negotiation (SPNEGO) Initiator Token and returns the results to the caller.
Authorities
No authorities are required.
Parameters
- init_token (Input)
- The SPNEGO initiator token encoded in Abstract Syntax Notation 1
Distinguished Encoding Rules (ASN.1 DER) format.
- parsed_token (Output)
- The information parsed from the initiator token.
The application should release the parsed token information when
it is no longer needed by calling the
qkrb_free_spnego_init_item()
routine.
Return Value
The return value is one of the following status codes:
- GSS_SPNEGO_SUCCESS (0)
- The routine completed successfully.
- GSS_SPNEGO_UNEXPECTED_ERR (1)
- The routine failed for unexpected reasons. Check the joblog for errors.
- GSS_SPNEGO_NOMEM (2)
- Memory allocation failed.
- GSS_SPNEGO_DEFECTIVE_TOKEN (3)
- Consistency checks performed on the input token failed.
- GSS_SPNEGO_INCOMPLETE_RESULTS (4)
- Unable to successfully parse all token items.
Partial results have been returned.
Related Information
For a description of the SPNEGO protocol, see RFC 2478 on the RFC Pages for The Simple and Protected GSS-API Negotiation Mechanism.
API introduced: V5R4
[ Back to top | Security APIs | UNIX-Type APIs | APIs by category ]