The returned enumerator can be used to walk all the entires or a subset of the key entries in a keystore.
All the "like" enum methods allow the caller to match part of passed in parameter against some part of a key's meta data. This function matches against a key's cipher algorithm.
This method is simular to the enumKeyByCipher() except that it takes a substring of a cipher name. This substring paramter is used in a SQL "like" query thus allowing the caller to match ciphers with wildcars both before and after the patter. For example, "AES" is treated as "*AES*" where '*' will match zero or more characters.
- Parameters
-
| pCipher | [ in ] A string representation of part or all of a cipher (e.g., "AES" matches "AES_CTR" and "AES_CFB"). |
| ppEnum | [ out ] identifiers for all matching keys |
- Returns
| Success | P6R::eOk | |
| Failure | P6R::eInvalidArg | ppEnum or pCipher is NULL. |
| P6R::eNotInitialized | A successful call to initialize was not made before this call. |
| P6R::eInvalidState | A successful call to open() was not made before this call. |
| P6R::eNotFound | No keys exist matching the request. |
