NAME
   CSSM_GetContext - Get context information (CDSA)

 SYNOPSIS
   # include <cssm.h>

        CSSM_RETURN CSSMAPI CSSM_GetContext
        (CSSM_CC_HANDLE CCHandle,
        CSSM_CONTEXT_PTR *Context)

 LIBRARY
   Common Security Services Manager library (CDSA$INCSSM300_SHR.EXE)

 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.

        CSSMERR_CSSM_INVALID_CONTEXT_HANDLE

 SEE ALSO
   Books

   Intel CDSA Application Developer's Guide (see CDSA)

   Other Help Topics

   Functions: CSSM_FreeContext
              CSSM_SetContext