Root > Reference > Events > TELEvPasswordRequestMeth

Type TELEvPasswordRequestMeth

 		Previous pageReturn to chapter overviewNext page   

Method event handler for OnPasswordRequest event.

 

Unit

EEvents

 

Syntax

 

Code (Delphi)

TELEvPasswordRequestMeth = procedure(

const AModule: HMODULE;

const APID: PGUID;

const APasswordHash: Pointer;

var APassword: String;

var ACallNextHandler: Boolean

) of object;

 

Parameters

AModule [in]

Module handle which password is retrieved.

 

APID [in, optional]

Pointer to unique project ID. Can be used to pick password from cache. This parameter is always assigned for EurekaLog 7+ modules.

 

APasswordHash [in, optional]

Pointer to EHash.TSHA1Hash. SHA1 hash of the UTF8-encoded password. Can be used to validate password. This parameter is always assigned for EurekaLog 7+ modules.

 

APassword [out]

Password for debug information.

 

ACallNextHandler [out]

True (default) - call next registered event handler, False - do not call next event handler.

 

Remarks

EurekaLog includes a OnPasswordRequest event for interaction with the user program when a raised exception is handled by EurekaLog and debug information was saved as encrypted. This event allow EurekaLog to obtain the exact password required to can decrypt all the encrypted data, otherwise all the data will be store in the bug report file in encrypted form, also error dialogs will show bug report in encrypted form.

 

The developer of application may use EurekaLog Viewer tool to decrypt encrypted bug reports.

 

You can use this event to supply your password to EurekaLog. By default this password is not stored in your executables. It's impossible to decrypt encrypted debug information without a password.

 

You can either ask user for password at run-time or retrieve it from application's configuration.

 

Note

This event will not be called if password was obtained by some other means (for example, loaded from local cache, or supplied via --el_password= cmd line argument, etc.).

 

Warning

Event handlers registered via TEurekaLogEvents component will be active only when corresponding form is live (created). Such handlers will not be called before form is created or after it was destroyed. For this reason you may want to register your event handlers via code. For example, it would be a bad idea to use TEurekaLogEvents component for implementing your error dialog, because your dialog will not be displayed for exceptions outside form (e.g. initialization/finalization exceptions, as well as exceptions in form's constructor).

 

See also



Send feedback... Build date: 2024-09-30
Last edited: 2024-09-30
PRIVACY STATEMENT
The documentation team uses the feedback submitted to improve the EurekaLog documentation. We do not use your e-mail address for any other purpose. We will remove your e-mail address from our system after the issue you are reporting has been resolved. While we are working to resolve this issue, we may send you an e-mail message to request more information about your feedback. After the issues have been addressed, we may send you an email message to let you know that your feedback has been addressed.

Permanent link to this article: https://www.eurekalog.com/help/eurekalog/topic_type_eevents_televpasswordrequestmeth.php