Search
Module:
Directory

   Desktop Functions:

   Smart Device Functions:


Show Recent Changes
Subscribe (RSS)
Misc. Pages
Comments
FAQ
Helpful Tools
Playground
Suggested Reading
Website TODO List
Download Visual Studio Add-In

WTSGetActiveConsoleSessionId (kernel32)
 
.
Summary
The WTSGetActiveConsoleSessionId function retrieves the Terminal Services session currently attached to the physical console. The physical console is the monitor, keyboard, and mouse.

C# Signature:

/// <summary>
/// The WTSGetActiveConsoleSessionId function retrieves the Remote Desktop Services session that
/// is currently attached to the physical console. The physical console is the monitor, keyboard, and mouse.
/// Note that it is not necessary that Remote Desktop Services be running for this function to succeed.
/// </summary>
/// <returns>The session identifier of the session that is attached to the physical console. If there is no
/// session attached to the physical console, (for example, if the physical console session is in the process
/// of being attached or detached), this function returns 0xFFFFFFFF.</returns>
[DllImport("kernel32.dll")]
private static extern uint WTSGetActiveConsoleSessionId();

VB .NET Signature:

/// Private Declare Function WTSGetActiveConsoleSessionId Lib "Kernel32.dll" Alias "WTSGetActiveConsoleSessionId" () As Int32

User-Defined Types:

None.

Notes:

None.

/// <summary>

/// The WTSGetActiveConsoleSessionId function retrieves the Remote Desktop Services session that

/// is currently attached to the physical console. The physical console is the monitor, keyboard, and mouse.

/// Note that it is not necessary that Remote Desktop Services be running for this function to succeed.

/// </summary>

/// <returns>The session identifier of the session that is attached to the physical console. If there is no

/// session attached to the physical console, (for example, if the physical console session is in the process

/// of being attached or detached), this function returns 0xFFFFFFFF.</returns>

[DllImport("kernel32.dll")]

private static extern uint WTSGetActiveConsoleSessionId();

Tips & Tricks:

See WTSQuerySessionInformation

VB .NET Signature:

/// Private Declare Function WTSGetActiveConsoleSessionId Lib "Kernel32.dll" Alias "WTSGetActiveConsoleSessionId" () As Int32

User-Defined Types:

None.

Sample Code:

  internal static uint GetSessionId()
  {
     uint result = WTSGetActiveConsoleSessionId();
     if (result == 0xFFFFFFFF)
    throw new InvalidOperationException("No session attached to the physical console.");

Notes:

None.

     return result;
  }

Tips & Tricks:

See WTSQuerySessionInformation

Alternative Managed API:

TODO

Sample Code:

  internal static uint GetSessionId()
  {
     uint result = WTSGetActiveConsoleSessionId();
     if (result == 0xFFFFFFFF)
    throw new InvalidOperationException("No session attached to the physical console.");

     return result;
  }

Alternative Managed API:

TODO

Documentation

Please edit this page!

Do you have...

  • helpful tips or sample code to share for using this API in managed code?
  • corrections to the existing content?
  • variations of the signature you want to share?
  • additional languages you want to include?

Select "Edit This Page" on the right hand toolbar and edit it! Or add new pages containing supporting types needed for this API (structures, delegates, and more).

 
Access PInvoke.net directly from VS:
Terms of Use
Edit This Page
Find References
Show Printable Version
Revisions