CSSM_GetContext

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