NAME    [Toc]    [Back]

       RetrieveCounter, CSSM_RetrieveCounter, CSP_RetrieveCounter
       - Get the value of a tamper resistant clock (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API:     CSSM_RETURN     CSSMAPI      CSSM_RetrieveCounter
       (CSSM_CSP_HANDLE  CSPHandle,  CSSM_DATA_PTR  Counter) SPI:
       CSSM_RETURN CSSMCSPI CSP_RetrieveCounter  (CSSM_CSP_HANDLE
       CSPHandle, CSSM_DATA_PTR Counter)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

PARAMETERS    [Toc]    [Back]

       The handle that describes the add-in cryptographic service
       provider module used to perform this function. If  a  NULL
       handle  is  specified,  CSSM  returns  error.   Pointer to
       CSSM_DATA structure  that  contains  data  of  the  tamper
       resistant clock/counter of the cryptographic device.

DESCRIPTION    [Toc]    [Back]

       This  function  returns  the  value  of a tamper resistant
       clock/counter of the cryptographic device.

NOTES ON SPI    [Toc]    [Back]

       The output is returned  to  the  caller  as  specified  in
       Buffer Management for Cryptographic Services.

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).

       None specific to this call.

SEE ALSO    [Toc]    [Back]

       Books

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

       Reference Pages    [Toc]    [Back]




                                               RetrieveCounter(3)