skip book previous and next navigation links
go up to top of book: HP Open Source Security for OpenVMS Volume 1:... HP Open Source Security for OpenVMS Volume 1:...
go to beginning of reference: API FunctionsAPI Functions
go to previous page: QuerySizeQuerySize
go to next page: RetrieveUniqueIdRetrieveUniqueId
end of book navigation links


RetrieveCounter
Library
Description
Return Value
See Also
 Parameters
Notes ON Spi
Errors

NAME

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

SYNOPSIS  

# include <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)


return to top LIBRARY  

Common Security Services Manager library (cdsa$incssm300_shr.exe)


return to top PARAMETERS  

CSPHandle (input)
 The handle that describes the add-in CryptographicService Provider module used to perform this function. If a NULLhandle is specified, CSSM returns error.
Counter (output)
 Pointer to CSSM_DATA structure that contains dataof the tamper resistant clock/counter of the cryptographic device.


return to top DESCRIPTION  

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


return to top NOTES ON SPI  

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


return to top RETURN VALUE  

A CSSM_RETURN value indicating success or specifying a particularerror condition. The value CSSM_OK indicates success. All othervalues represent an error condition.


return to top ERRORS  

Errors are described in the CDSA Technical Standard.

None specific to this call.


return to top SEE ALSO  

Books

Intel CDSA Application Developer's Guide


go to previous page: QuerySizeQuerySize
go to next page: RetrieveUniqueIdRetrieveUniqueId