HP Open Source Security for OpenVMS Volume 3: Kerberos > Chapter 5 GSSAPI (Generic Security Services Application Programming Interface)

gss_import_sec_context — Import a transferred context

  Table of Contents

  Glossary

  Index

C Prototype

OM_uint32 gss_import_sec_context(
OM_uint32 * minor_status,
gss_buffer_t interprocess_token,
gss_ctx_id_t * context_handle );

Arguments

minor_status (output) 

An implementation-specific status code.

interprocess_token (input/output)
  

The token received from the exporting process.

context_handle (output) 

The context handle of the newly reactivated context. Resources associated with this context handle must be released by the application after use with a call to gss_delete_sec_context.

Description

This routine allows a process to import a security context established by another process. A given interprocess token may be imported only once. See gss_export_sec_context for additional information.

Return Values

This routine returns one of the following GSS status codes:

GSS_S_COMPLETE

Successful completion.
GSS_S_NO_CONTEXTThe token did not contain a valid context reference.
GSS_S_DEFECTIVE_TOKENThe token was invalid.
GSS_S_UNAVAILABLEThe operation is unavailable.

GSS_S_UNAUTHORIZED

Local policy prevents the import of this context by the current process.