NAME    [Toc]    [Back]

       CSSM_UpdateContextAttributes  -  Update  context attribute
       values (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       CSSM_RETURN      CSSMAPI      CSSM_UpdateContextAttributes
       (CSSM_CC_HANDLE CCHandle, uint32 NumberOfAttributes, const
       CSSM_CONTEXT_ATTRIBUTE *ContextAttributes)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

PARAMETERS    [Toc]    [Back]

       The  handle  to  the  existing  context.   The  number  of
       CSSM_CONTEXT_ATTRIBUTE structures to allocate.  Pointer to
       data that describes the attributes to be  associated  with
       this context.

DESCRIPTION    [Toc]    [Back]

       This function updates one or more context attribute values
       stored as part of an existing context specified by  CCHandle.
  The  basic context structure is not modified by this
       function. Only the context attributes are updated.

       The NumberOfAttributes parameter specifies the  number  of
       attributes  to update. The new attribute values are specified
 in ContextAttributes. If  an  attribute  provided  in
       ContextAttributes  is already present in the existing context,
 the existing value is replaced by the new value.  If
       an  attribute provided in ContextAttributes is not present
       in the existing context, then the new attribute is  added.
       Attribute  values are never deleted from the existing context.

RETURN VALUE    [Toc]    [Back]

       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    [Toc]    [Back]

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

SEE ALSO    [Toc]    [Back]

       Books

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

       Reference Pages    [Toc]    [Back]

       Functions:  CSSM_DeleteContextAttributes(3),  CSSM_GetContextAttribute(3)



                                  CSSM_UpdateContextAttributes(3)