Developer's Guide
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
virtual P6R::P6ERR P6R::p6IKeystoreQuery3::enumByAttributeString ( P6KEYSTORE_TYPE  entryType,
const P6WCHAR pName,
const P6WCHAR pValueStr,
p6IEnumKeystore **  ppEnum 
)
pure virtual

The returned enumerator can be used to walk all the entires or a subset of the entries in a keystore that have a specific attribute set with a string value.

For example, find all keys with the attribute "Revocation Reason" string value of "Compromised".

Parameters
entryType[ in ] the type of keystore object to search for (e.g., key, certificate), ENTRY_NULL means all types of objects.
pName[ in ] the name of an attribute to search for
pValueStr[ in ] the string value of the attribute pName to search for
ppEnum[ out ] identifiers for all matching keystore entries
Returns
SuccessP6R::eOk 
FailureP6R::eInvalidArgpName, pValueStr, or ppEnum is NULL.
P6R::eNotInitializedA successful call to initialize was not made before this call.
P6R::eInvalidStateA successful call to open() was not made before this call.
P6R::eNotFoundNo objects exist matching the request.