class KeyChainSearchItemMBS
class, KeyChain, MBS Mac Plugin (KeyChain), class KeyChainSearchItemMBS, Console safe, Plugin version: 2.6, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.

Function: A class for a KeyChain search.

KeyChainSearchItemMBS.FindNext as boolean
method, KeyChain, MBS Mac Plugin (KeyChain), class KeyChainSearchItemMBS, Console safe, Plugin version: 2.6, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.

Function: Searches for the next KeyChainItemMBS.
Example:

dim m as new KeyChainManagerMBS
dim s as KeyChainSearchItemMBS
dim it as KeyChainItemMBS
dim text as string

const kServiceKCItemAttr="svce"
const kAccountKCItemAttr="acct"

listbox1.DeleteAllRows

s=m.KeyChainFindFirst(nil)

do
  it=s.Item
  
  text=it.GetString(kServiceKCItemAttr,1000)
  if text="RBTest" then
    Listbox1.AddRow it.GetString(kAccountKCItemAttr,1000)
  end if
loop until not s.FindNext

KeyChainSearchItemMBS.Handle as integer
property, KeyChain, MBS Mac Plugin (KeyChain), class KeyChainSearchItemMBS, Console safe, Plugin version: 2.6, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.

Function: The handle for this search.
Notes:
The handle is a KCSearchRef value.
(Read only property)

KeyChainSearchItemMBS.Item as KeyChainItemMBS
property, KeyChain, MBS Mac Plugin (KeyChain), class KeyChainSearchItemMBS, Console safe, Plugin version: 2.6, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.

Function: The current found item.
Notes: (Read only property)

KeyChainSearchItemMBS.Lasterror as Integer
property, KeyChain, MBS Mac Plugin (KeyChain), class KeyChainSearchItemMBS, Console safe, Plugin version: 6.3, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.

Function: The number representing the last error reported.
Notes:
If a function is not available (e.g. KeyChain Manager not installed), the lasterror property has the value -1. If the plugin was unable to allocate memory, -2 is returned.

KeyChain Manager error codes:

errKCNotAvailable	-25291	Indicates that the KeyChain Manager was not loaded.
errKCReadOnly	-25292	Returned by the function KCCopyItem to indicate that the KeyChain file is read-only and cannot be edited.
errKCAuthFailed	-25293	Returned by the function KCUnlock to indicate that the authentication failed (too many unsuccessful retries).
errKCNoSuchKeychain	-25294	Returned by the functions KCUnlock, KCSetDefaultKeychain, KCGetStatus, and KCGetIndKeychain to indicate that the specified KeyChain was not found.
errKCInvalidKeychain	-25295	Returned by the functions KCUnlock, KCSetDefaultKeychain, KCGetStatus, KCGetKeychainName, KCChangeSettings, and KCCreateKeychain to indicate that the KeyChain is not valid.
errKCDuplicateKeychain	-25296	Returned by the function KCCreateKeychain to indicate that your application tried to create a KeyChain that already exists.
errKCDuplicateCallback	-25297	Returned by the function KCAddCallback to indicate that your callback function was already registered.
errKCInvalidCallback	-25298	Returned by the function KCRemoveCallback to indicate that the callback function was not previously registered.
errKCDuplicateItem	-25299	Returned by the functions KCAddAppleSharePassword, KCAddInternetPassword, KCAddInternetPasswordWithPath, KCAddGenericPassword, and KCAddItem to indicate that you tried to add an existing KeyChain item to the KeyChain.
errKCItemNotFound	-25300	Returned by the functions KCFindAppleSharePassword, KCFindInternetPassword, KCFindInternetPasswordWithPath, KCFindGenericPassword, KCFindNextItem, and KCFindFirstItem to indicate that no matching item was found.
errKCBufferTooSmall	-25301	Returned by the functions KCFindAppleSharePassword, KCFindInternetPassword, KCFindInternetPasswordWithPath, KCFindGenericPassword, KCGetAttribute, KCGetData, and KCFindX509Certificates to indicate that the buffer was not large enough to contain the password data.
errKCDataTooLarge	-25302	Returned by the functions KCAddAppleSharePassword, KCAddInternetPassword, KCAddInternetPasswordWithPath, KCAddGenericPassword, KCSetAttribute, and KCSetData to indicate that the data is too large.
errKCNoSuchAttr	-25303	Returned by the functions KCSetAttribute, KCGetAttribute, and KCFindFirstItem to indicate that no such attribute exists.
errKCInvalidItemRef	-25304	Returned by the functions KCSetAttribute, KCGetAttribute, KCSetData, KCGetData, KCAddItem, KCDeleteItem, KCUpdateItem, KCCopyItem, and KCGetKeychain to indicate that the KeyChain item reference is invalid.
errKCInvalidSearchRef	-25305	Returned by the functions KCFindNextItem and KCReleaseSearch to indicate that the specified search reference is invalid.
errKCNoSuchClass	-25306	Returned by the function KCCopyItem to indicate that the item class does not exist.
errKCNoDefaultKeychain	-25307	Returned by the functions KCChangeSettings, KCSetDefaultKeychain, KCGetDefaultKeychain, KCAddAppleSharePassword, KCAddInternetPassword, KCAddInternetPasswordWithPath, KCAddGenericPassword, KCFindAppleSharePassword, KCFindInternetPassword, KCFindInternetPasswordWithPath, KCFindGenericPassword, KCCopyItem, KCAddItem, KCDeleteItem, KCUpdateItem, KCFindNextItem, KCFindFirstItem, and KCFindX509Certificates to indicate that there is no default KeyChain.
errKCInteractionNotAllowed	-25308	Returned by the functions KCCreateKeychain, KCChangeSettings, KCUnlock, and KCGetData (the latter two only when the Unlock Dialog and Allow Access dialog boxes are needed) to indicate that there is no start-up KeyChain.
errKCReadOnlyAttr	-25309	Returned by the function KCSetAttribute to indicate that the KeyChain item attribute is read-only.
errKCWrongKCVersion	-25310	Indicates that the wrong version of KeyChain Manager is installed to perform this operation.
errKCKeySizeNotAllowed	-25311	Indicates that the key size is illegal.
errKCNoStorageModule	-25312	Returned by functions that prompts the loading of the KeyChain Manager to indicate that the storage module is not found.
errKCNoCertificateModule	-25313	Returned when a function is required for a certificate and the certificate module is not found.
errKCNoPolicyModule	-25314	Returned when a function is required for a trust policy and the policy module is not found.
errKCInteractionRequired	-25315	Returned by the function KCUnlock to indicate that user interaction is required for this operation.
errKCDataNotAvailable	-25316	Indicates that the requested data is not available.
errKCDataNotModifiable	-25317	Returned by the functions KCSetData and KCGetData to indicate that the data cannot be modified.
errKCCreateChainFailed	-25318	Returned by the functions KCChooseCertificate and KCFindX509Certificates to indicate that the attempt to create a new KeyChain failed.

(Read only property)