virtual P6R::P6ERR P6R::p6IKeystoreQuery3::enumKeyReferenceLikeLocation ( const P6WCHAR *  pLocation, p6IEnumKeystore **  ppEnum  )

pure virtual

The returned enumerator can be used to walk all the entires or a subset of the key reference 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 reference's meta data. This function matches against a key reference's location field, which has an application defined structure and content (e.g., IP address, FQDN, URL).

Parameters

pLocation	[ in ] A string representation of part or all of the value passed in P6KEYSTORE_KEYREF.szRemoteLocation when calling p6IKeystore5::setKeyReference().
ppEnum	[ out ] identifiers for all matching keys

Returns

Success	P6R::eOk
Failure	P6R::eInvalidArg	ppEnum or pLocation 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 key references exist matching the request.