IMsRdpClient::get_ExtendedDisconnectReason (Windows Embedded CE 6.0)
1/6/2010
This method retrieves extended information about why the Remote Desktop ActiveX control disconnected. This interface was added for RDP clients (version 5.1 and later).
Syntax
HRESULT get_ExtendedDisconnectReason(
ExtendedDisconnectReasonCode* pExtendedDisconnectReason
);
Parameters
pExtendedDisconnectReason
[out, retval] Pointer to a code specifying the reason why the client disconnected. The following table shows possible values for this parameter.Value Description exDiscReasonNoInfo (0x0000)
No additional information is available.
exDiscReasonAPIInitiatedDisconnect (0x0001)
An application initiated the disconnection.
exDiscReasonAPIInitiatedLogoff (0x0002)
An application logged off the client.
exDiscReasonServerIdleTimeout (0x0003)
The server has disconnected the client because the client has been idle for a period of time longer than the designated timeout period.
exDiscReasonServerLogonTimeout (0x0004)
The server has disconnected the client because the client has exceeded the period designated for connection.
exDiscReasonReplacedByOtherConnection (0x0005)
The client's connection was replaced by another connection.
exDiscReasonOutOfMemory (0x0006)
No memory is available.
exDiscReasonServerDeniedConnection (0x0007)
The server refused the connection.
exDiscReasonLicenseInternal (0x0100)
Internal licensing error.
exDiscReasonLicenseNoLicenseServer (0x0101)
No licensing server was available.
exDiscReasonLicenseNoLicense (0x0102)
No valid software license was available.
exDiscReasonLicenseErrClientMsg (0x0103)
The remote computer received an invalid licensing message.
exDiscReasonLicenseHwidDoesntMatchLicense (0x0104)
The hardware ID does not match the ID on the software license.
exDiscReasonLicenseErrClientLicense (0x0105)
Client license error.
exDiscReasonLicenseCantFinishProtocol (0x0106)
Network problems occurred during the licensing protocol.
exDiscReasonLicenseClientEndedProtocol (0x0107)
The client ended the licensing protocol prematurely.
exDiscReasonLicenseErrClientEncryption (0x0108)
A licensing message was encrypted incorrectly.
exDiscReasonLicenseCantUpgradeLicense (0x0109)
The local computer's client access license could not be upgraded or renewed.
exDiscReasonLicenseNoRemoteConnections (0x010A)
The remote computer is not licensed to accept remote connections.
exDiscReasonProtocolRangeStart (0x1000) through exDiscReasonProtocolRangeEnd (0x7FFF)
Values in this range represent internal protocol errors. Check the server event log for additional details.
Return Value
If the method succeeds, the return value is S_OK.
If it fails, the method returns a nonzero error code.
Remarks
This method is typically called in the IMsTscAxEvents::OnDisconnected event handler to retrieve additional information about the disconnection event.
Requirements
| Header | discodlg.h, mstsax.idl |
| Library | Mstsax.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |