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 use.
- Parameters
-
pUse | [ in ] A string representation of part or all of a "human or machine readable description on how key is to be used (e.g., sign SSH packages)", as set by the method: p6ICryptoKeySetMeta::setUse() |
ppEnum | [ out ] identifiers for all matching keys |
- Returns
Success | P6R::eOk | |
Failure | P6R::eInvalidArg | ppEnum or pUse 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. |