SecureBlackbox 2020 C++ Edition

Questions / Feedback?

Select Method

Filters a selection of keys from the keyring using a template.

Syntax

ANSI (Cross Platform)
int Select(const char* lpszFilter, int bSecretOnly, int iMaxCount);

Unicode (Windows)
INT Select(LPCWSTR lpszFilter, BOOL bSecretOnly, INT iMaxCount);
- (void)select:(NSString*)filter :(BOOL)secretOnly :(int)maxCount;
#define MID_PGPKEYRING_SELECT 20

SECUREBLACKBOX_EXTERNAL int SECUREBLACKBOX_CALL SecureBlackbox_PGPKeyring_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

Use this method to get a list of keys that satisfy the Filter criteria. The filter should follow the "Name=Value" format, where Name can be one of the following: userid, fp, fingerprint, and keyid.

Set SecretOnly to True to only search for secret keys. MaxCount allows to limit the number of keys returned.

Once the method completes, the keys that match the criteria will be available in SelectedPublicKeys and SelectedSecretKeys properties.

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

Copyright (c) 2022 /n software inc. - All rights reserved.
SecureBlackbox 2020 C++ Edition - Version 20.0 [Build 8166]