HP Open Source Security for OpenVMS Volume 3: Kerberos > Chapter 6 KRB5 (Kerberos V5) Application Programming Interface

krb5_auth_con_getauthenticator — Retrieve authenticator used during mutual authentication

  Table of Contents

  Glossary

  Index

C Prototype

krb5_error_code krb5_auth_con_getauthenticator(
krb5_context context,
krb5_auth_context auth_context,
krb5_authenticator **authenticator );

Arguments

context (input/output) 

The context structure.

auth_context (input/output)  

A per-connection context.

authenticator (output) 

The authenticator used during mutual authentication.

Description

This routine retrieves the authenticator that was used during mutual authentication. It is the caller’s responsibility to free the memory allocated to authenticator by calling krb5_free_authenticator.

Return Values

This routine returns the following KRB5 status code:

0

Successful completion.