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 |
|
| DLL |
|
| IID |
IMsTscAxEvents is defined as 336d5562-efa8-482e-8cb3-c5c0fc7a7db6 |