CSSM_RetrieveUniqueId
CSSM_RETURN CSSMAPI CSSM_RetrieveUniqueId
(CSSM_CSP_HANDLE CSPHandle,
CSSM_DATA_PTR UniqueID)
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.
- 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.
A CSSM_OK return value signifies that the identifier is retrieved. If CSSM_FAIL is returned, an error has occurred. Use CSSM_GetError to obtain the error code.
- CSSM_INVALID_CSP_HANDLE
Invalid provider handle.
- CSSM_INVALID_POINTER
Invalid pointer.
- CSSM_FUNCTION_NOT_IMPLEMENTED
Function not implemented.
Contents | Next section | Index |