Index Index for
Section 3
Index Alphabetical
listing for R
Bottom of page Bottom of
page		 

RetrieveUniqueId(3)


NAME

  RetrieveUniqueId, CSSM_RetrieveUniqueId, CSP_RetrieveUniqueId - Get
  identifier (CDSA)


SYNOPSIS

  # 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

  Common Security Services Manager library (libcssm.so)


PARAMETERS

  CSPHandle (input)
	  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.

  UniqueID (output)
	  Pointer to CSSM_DATA structure that contains data that uniquely
	  identifies the cryptographic device.


DESCRIPTION

  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

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


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_intro(3).

  None specific to this call.


SEE ALSO

  Books

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

  Reference Pages

Index Index for
Section 3
Index Alphabetical
listing for R
Top of page Top of
page