IMsTscAxEvents::OnLogonError method

Called when a logon error or other logon event occurs.

Syntax

void OnLogonError(
  [in] LONG lError
);

Parameters

lError [in]

The logon error code. This list of codes is not exhaustive.

ARBITRATION_CODE_BUMP_OPTIONS (-5 (0xFFFFFFFB))

Winlogon is displaying the Session Contention dialog box.

ARBITRATION_CODE_CONTINUE_LOGON (-2 (0xFFFFFFFE))

Winlogon is continuing with the logon process.

ARBITRATION_CODE_CONTINUE_TERMINATE (-3 (0xFFFFFFFD))

Winlogon is ending silently.

ARBITRATION_CODE_NOPERM_DIALOG (-6 (0xFFFFFFFA))

Winlogon is displaying the No Permissions dialog box.

ARBITRATION_CODE_REFUSED_DIALOG (-7 (0xFFFFFFF9))

Winlogon is displaying the Disconnect Refused dialog box.

ARBITRATION_CODE_RECONN_OPTIONS (-4 (0xFFFFFFFC))

Winlogon is displaying the Reconnect dialog box.

ERROR_CODE_ACCESS_DENIED (-1 (0xFFFFFFFF))

The user was denied access.

LOGON_FAILED_BAD_PASSWORD (0 (0x0))

The logon failed because the logon credentials are not valid.

LOGON_FAILED_OTHER (2 (0x2))

Another logon or post-logon error occurred. The Remote Desktop client displays a logon screen to the user.

LOGON_FAILED_UPDATE_PASSWORD (1 (0x1))

The password is expired. The user must update their password to continue logging on.

LOGON_WARNING (3 (0x3))

The Remote Desktop client displays a dialog box that contains important information for the user.

STATUS_ACCOUNT_RESTRICTION (-1073741714 (0xC000006E))

The user name and authentication information are valid, but authentication was blocked due to restrictions on the user account, such as time-of-day restrictions.

STATUS_LOGON_FAILURE (-1073741715 (0xC000006D))

The attempted logon is not valid. This is due to either an incorrect user name or incorrect authentication information.

STATUS_PASSWORD_MUST_CHANGE (-1073741276 (0xC0000224))

The password is expired. The user must update their password to continue logging on.

Return value

This method does not return a value.

Remarks

Implement this method in your event sink to receive notification that a logon error has occurred.

This list of codes is not exhaustive.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Type library	MsTscAx.dll
DLL	MsTscAx.dll
IID	IMsTscAxEvents is defined as 336d5562-efa8-482e-8cb3-c5c0fc7a7db6

See also

IMsTscAxEvents