Takes a symmetric key and "localizes" it with the byte sequence pointed to by "pEngineID".
This function generates a new symetric key and saves it into the file named by the parameter "pKeyFile" in PEM format. (This includes generating a new IV for the localized key.) Note, that currently the generated key file is not encrypted.
- Parameters
-
pInKey | [ in ] A pointer to a p6ICryptoKey interface containing the master key to localize. |
ppOutKey | [ out ] The address of a p6ICryptoKey interface pointer in which will be placed the localized key. |
pEngineID | [ in ] SNMP specific string of variable length. This can be a binary byte sequence (i.e., not NULL terminated). |
idSize | [ in ] The number of bytes of data pointed to by pEngineID. |
pEntropy | [ in ] Pointer to a plugin interface to provide the entropy requried for key generation. If set to NULL, then a default entropy source will be used. |
- Returns
Success | P6R::eOk | |
Failure | eInvalidArg | One of the parameters is NULL or idSize is zero. |
eNotInitialized | A successful call to initialize was not made before this call. |
eIoError | Could not create the key file. |
eFormatError | A symetric key has not been loaded before this call. |
eFail | The key generation calculation failed. |