TElPGPReader.OnKeyPassphrase event

Navigation

Filter: C# VB.NET Pascal ActiveX DLL TElPGPReader.OnKeyPassphrase TElPGPReader See also
This event is fired when a password for the key is required.

Declaration [C#] event TSBPGPKeyPassphraseEvent OnKeyPassphrase; delegate void TSBPGPKeyPassphraseEvent(object Sender, TElPGPCustomSecretKey Key, ref string Passphrase, ref bool Cancel) [VB.NET] Event OnKeyPassphrase As TSBPGPKeyPassphraseEvent Delegate Sub TSBPGPKeyPassphraseEvent(ByVal Sender As Object, ByVal Key As TElPGPCustomSecretKey, ByRef Passphrase As String, ByRef Cancel As Boolean) [Pascal] property OnKeyPassphrase : TSBPGPKeyPassphraseEvent; TSBPGPKeyPassphraseEvent = procedure(Sender: TObject; Key : TElPGPCustomSecretKey; var Passphrase: string; var Cancel: boolean) of object; [VB6] Event IElPGPReaderXEvents.OnKeyPassphrase( ByVal Key As IElPGPCustomSecretKeyX, ByRef Passphrase As String, ByRef Cancel As Boolean) [ActiveX] void IElPGPReaderXEvents.OnKeyPassphrase( [in] IElPGPCustomSecretKeyX * Key, [in, out] BSTR * Passphrase, [in, out] VARIANT_BOOL * Cancel); [DLL] not implemented;

Parameters Key - key which needs password. Passphrase - password. Cancel - True if the password can't be provided and processing must be cancelled.

Description This event is fired by TElPGPReader when it needs a password to access a secret key. The event is fired until correct password is passed or Cancel parameter is set to True. If the data contains multiple keys, OnKeyPassphrase is called for each key in a loop until the password for some key is provided correctly. For each key OnKeyPassphrase is called in a loop until the password is provided correctly or Cancel is set to True. If the password is provided correctly, then both loops are stopped and the key for which the password has been provided is used. If Cancel is set to True, OnKeyPassphrase is not called for the particular key, and processing advances to the next key.

See also: KeyPassphrase OnArmored OnCompressed OnCreateOutputStream OnEncrypted OnPassphrase OnProgress OnSigned