Copyright Digital Equipment Corp. All rights reserved.

CSSM_GetContextAttribute

NAME
  CSSM_GetContextAttribute - Get context attribute (CDSA)

SYNOPSIS
  # include <cssm.h>

       CSSM_RETURN CSSMAPI CSSM_GetContextAttribute
       (const CSSM_CONTEXT *Context,
       uint32 AttributeType,
       CSSM_CONTEXT_ATTRIBUTE_PTR *ContextAttribute)

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

PARAMETERS
  Context (input)
          A pointer to the context.

  AttributeType (input)
          The attribute type of the desired attribute value.

  ContextAttribute (output)
          The pointer to the CSSM_CONTEXT_ATTRIBUTE that describes the
          context attributes associated with the CCHandle handle and
          the attribute type. The pointer will be set to NULL if the
          function fails.  Call CSSM_DeleteContextAttributes() to free
          memory allocated by the CSSM.

DESCRIPTION
  This function returns the value of a context attribute. Context
  references the cryptographic context to be searched for the attribute
  specified by AttributeType. If the specified attribute is not present,
  then a NULL pointer is returned.

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_ATTRIBUTE_NOT_IN_CONTEXT

SEE ALSO
  Books

  Intel CDSA Application Developer's Guide (see CDSA)

  Other Help Topics

  Functions: CSSM_DeleteContextAttributes
             CSSM_GetContext