TMS International BV |
GetRandomKey
BOOLEAN APIENTRY GetRandomKey(
void *Handle,
char *Key,
unsigned int *LengthKeyInBytes
);
Parameters
Handle
Handle of the library
Key
Array in which the retrieved key is stored.
LengthKeyInBytes
Length of the given array in bytes.
Return Value
If successful this function returns TRUE, else FALSE. If the function returns FALSE, use GetErrorCode to get the error code.
Comments
This function is not supported by all front ends. The Open()
function must
have been called before. This function will retrieve a random key from
the frontend. The given array should have a length of at least 16 bytes
(=128 bits). The retrieved key must be transformed in an OEM-specific
way. Then the transformed key is given to UnlockFrontend to unlock the
frontend for further use.
Also see