The digestStart(), digestContinue(), and digestEnd() methods comprise a streaming digest interface.
A streaming interface allows the caller to add blocks of data one at a time and does not require all the entire message be contained in a single buffer in order to generate a digest. The digestContinue() method can be called multiple times, one for each block of data to be included in the digest while the digestStart() and digestEnd() are only called once.
- Parameters
-
algorithm | [ in ] defines which digest algorithm data to use |
base64Encode | [ in ] Flag indicating whether the resulting digest should be encoded in base64 (otherwise it is binary string) |
- Returns
Success | P6R::eOk | |
Failure | P6R::eNotInitialized | A successful call to initialize was not made before this call. |
P6R::eInvalidArg | One of the parameters is NULL. |
P6R::eInvalidState | A streaming digest has not completed with a call to the digestEnd() method. |
P6R::eFailAndException | The digest calculation failed. Exception record provides detailed error info. |