TElPGPKeyring.FindSecretKeyByEmailAddress method

TElPGPKeyring.FindSecretKeyByEmailAddress

TElPGPKeyring See also

Filter: C# VB.NET Pascal C++ PHP Java

Searches secret key in the keyring by its e-mail address.

Declaration

[C#]
int FindSecretKeyByEmailAddress(string Address, int StartIndex);

[VB.NET]
Function FindSecretKeyByEmailAddress(ByVal Address As String, ByVal StartIndex As Integer) As Integer

[Pascal]
function FindSecretKeyByEmailAddress(const Address : string; StartIndex : integer = 0) : integer;

[C++]
int32_t FindSecretKeyByEmailAddress(const std::string &Address, int32_t StartIndex);

[PHP]
integer FindSecretKeyByEmailAddress(string $Address, integer $StartIndex)

[Java]
int findSecretKeyByEmailAddress(String Address, int StartIndex);

Parameters

Address - the e-mail address to be found
StartIndex - index of the key from which the search must start.
Default value is 0.

Return value

Index of the found key or -1 if nothing was found.

Description

Use this method when you need to find secret key with specified e-mail address. Note, that some keys can have the same e-mail addresses. So you need to check that the key found is the one you've searched for, and if no, search again with new value of StartIndex parameter.
Please also note, that this method searches for a given substring in the UserID information, so any substring of a user name can be used as a search criterion (not e-mail address only).

Discuss this help topic in SecureBlackbox Forum