NAME    [Toc]    [Back]

       RetrieveUniqueId,   CSSM_RetrieveUniqueId,  CSP_RetrieveUniqueId
 - Get identifier (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API:     CSSM_RETURN     CSSMAPI     CSSM_RetrieveUniqueId
       (CSSM_CSP_HANDLE  CSPHandle,  CSSM_DATA_PTR UniqueID) SPI:
       CSSM_RETURN CSSMCSPI CSP_RetrieveUniqueId (CSSM_CSP_HANDLE
       CSPHandle, CSSM_DATA_PTR UniqueID)

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 that uniquely identifies
 the cryptographic device.

DESCRIPTION    [Toc]    [Back]

       This  function returns an identifier that could be used to
       uniquely differentiate the cryptographic device  from  all
       other devices from the same vendor or different vendors.

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]




                                              RetrieveUniqueId(3)