NAME

CSSM_VerifyDevice

SYNOPSIS

CSSM_RETURN CSSMAPI CSSM_VerifyDevice
    (CSSM_CSP_HANDLE CSPHandle,
    const CSSM_DATA_PTR DeviceCert)

DESCRIPTION

This function triggers the cryptographic module to perform self verification and integrity checking.

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.

DeviceCert (input)

Pointer to CSSM_DATA structure that contains data that identifies the cryptographic device.

RETURN VALUE

A CSSM_OK return value signifies that the verification was successful. If CSSM_FAIL is returned, an error has occurred. Use CSSM_GetError to obtain the error code.

ERRORS

CSSM_INVALID_CSP_HANDLE

Invalid provider handle.

CSSM_INVALID_POINTER

Invalid pointer.

CSSM_VERIFICATION_FAIL

Device unable to verify itself.

CSSM_FUNCTION_NOT_IMPLEMENTED

Function not implemented.