NAME

CSSM_GetContext − Get context information (CDSA)

SYNOPSIS

# include <cdsa/cssm.h>

CSSM_RETURN CSSMAPI CSSM_GetContext
(CSSM_CC_HANDLE CCHandle,
CSSM_CONTEXT_PTR ∗Context)

LIBRARY

Common Security Services Manager library (libcssm.so)

PARAMETERS

CCHandle (input)
The handle to the context information.

Context (output)
The pointer to the CSSM_CONTEXT_PTR structure that describes the context associated with the CCHandle handle.  The pointer will be set to NULL if the function fails. Use CSSM_FreeContext() to free the memory allocated by the CSSM. 

DESCRIPTION

This function retrieves the context information when provided with a context handle. 

RETURN VALUE

A CSSM_RETURN value indicating success or specifying a particular error condition. The value CSSM_OK indicates success. All other values represent an error condition. 

ERRORS

Errors are described in the CDSA technical standard.  See CDSA_intro(3). 

CSSMERR_CSSM_INVALID_CONTEXT_HANDLE

SEE ALSO

Books

Intel CDSA Application Developer’s Guide (see CDSA_intro(3))

Reference Pages

Functions: CSSM_FreeContext(3), CSSM_SetContext(3)