Fired in case if ViewerX has failed to authenticate with VNC server. The caller can use this even to suppress the default password prompt dialog box as well as the "authentication failed" message box.

Syntax

HRESULT AuthenticationFailed(VARIANT_BOOL* pbCancelAndDontPromptForPassword);

Parameters

pbCancelAndDontPromptForPassword

Pointer to a variable of type VARIANT_BOOL* that allows the cancellation of the default password prompt dialog. If VARIANT_TRUE, the password dialog and the "authentication failed" message boxes are suppressed; VARIANT_FALSE allows those dialog boxes to be displayed.
Default value: VARIANT_FALSE

Remarks

If attempt to establish connection was performed using asynchronous connection with either ConnectAsync() or ConnectAsyncEx() methods, then the event sink callback function will be executed in the non-GUI thread.

Do not attempt to re-establish a connection inside the AuthenticationFailed event sink callback function body.

Return Value

Returns S_OK if successful, or an error value otherwise.