Click or drag to resize
Xcalibur Systems LLC Logo

TerminalServicesHelperWTSDisconnectSession Method

Disconnects the logged-on user from the specified Remote Desktop Services session without closing the session. If the user subsequently logs on to the same Remote Desktop Session Host (RD Session Host) server, the user is reconnected to the same session.

WTSDisconnectSession function


Namespace: Xcalibur.NativeMethods.V2.TerminalServices
Assembly: Xcalibur.NativeMethods.V2 (in Xcalibur.NativeMethods.V2.dll) Version: 1.0.1.0
Syntax
[DllImportAttribute("wtsapi32.dll", SetLastError = true)]
public static bool WTSDisconnectSession(
	IntPtr serverHandle,
	int sessionId,
	bool wait
)

Parameters

serverHandle  IntPtr
A handle to an RD Session Host server opened by a call to the or WTSOpenServerEx function, or specify WTS_CURRENT_SERVER_HANDLE to indicate the RD Session Host server on which your application is running.
sessionId  Int32
A Remote Desktop Services session identifier. To indicate the current session, specify WTS_CURRENT_SESSION. To retrieve the identifiers of all sessions on a specified RD Session Host server, use the WTSEnumerateSessions function. To be able to disconnect another user's session, you need to have the Disconnect permission. For more information, see Remote Desktop Services Permissions. To modify permissions on a session, use the Remote Desktop Services Configuration administrative tool. To disconnect sessions running on a virtual machine hosted on a RD Virtualization Host server, you must be a member of the Administrators group on the RD Virtualization Host server.
wait  Boolean
Indicates whether the operation is synchronous. Specify TRUE to wait for the operation to complete, or FALSE to return immediately.

Return Value

Boolean
If the function succeeds, the return value is nonzero. To determine whether the function adjusted all of the specified privileges, call .
See Also