com.sun.jna.platform.win32.Wtsapi32 Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of jna-platform Show documentation
Show all versions of jna-platform Show documentation
Java Native Access Platform
/* Copyright (c) 2012 Tobias Wolf, All Rights Reserved
*
* The contents of this file is dual-licensed under 2
* alternative Open Source/Free licenses: LGPL 2.1 or later and
* Apache License 2.0. (starting with JNA version 4.0.0).
*
* You can freely decide which license you want to apply to
* the project.
*
* You may obtain a copy of the LGPL License at:
*
* http://www.gnu.org/licenses/licenses.html
*
* A copy is also included in the downloadable source code package
* containing JNA, in file "LGPL2.1".
*
* You may obtain a copy of the Apache License at:
*
* http://www.apache.org/licenses/
*
* A copy is also included in the downloadable source code package
* containing JNA, in file "AL2.0".
*/
package com.sun.jna.platform.win32;
import com.sun.jna.Native;
import com.sun.jna.Pointer;
import com.sun.jna.Structure;
import com.sun.jna.Structure.FieldOrder;
import com.sun.jna.platform.win32.WinDef.HWND;
import com.sun.jna.platform.win32.WinNT.HANDLE;
import com.sun.jna.platform.win32.WinNT.LARGE_INTEGER;
import com.sun.jna.platform.win32.WinNT.PSID;
import com.sun.jna.ptr.IntByReference;
import com.sun.jna.ptr.PointerByReference;
import com.sun.jna.win32.StdCallLibrary;
import com.sun.jna.win32.W32APIOptions;
import com.sun.jna.win32.W32APITypeMapper;
public interface Wtsapi32 extends StdCallLibrary {
Wtsapi32 INSTANCE = Native.load("Wtsapi32", Wtsapi32.class, W32APIOptions.DEFAULT_OPTIONS);
int NOTIFY_FOR_ALL_SESSIONS = 1;
int NOTIFY_FOR_THIS_SESSION = 0;
/**
* The session identified by lParam was connected to the console terminal or
* RemoteFX session.
*/
int WTS_CONSOLE_CONNECT = 0x1;
/**
* The session identified by lParam was disconnected from the console
* terminal or RemoteFX session.
*/
int WTS_CONSOLE_DISCONNECT = 0x2;
/**
* The session identified by lParam was connected to the remote terminal.
*/
int WTS_REMOTE_CONNECT = 0x3;
/**
* The session identified by lParam was disconnected from the remote
* terminal.
*/
int WTS_REMOTE_DISCONNECT = 0x4;
/**
* A user has logged on to the session identified by lParam.
*/
int WTS_SESSION_LOGON = 0x5;
/**
* A user has logged off the session identified by lParam.
*/
int WTS_SESSION_LOGOFF = 0x6;
/**
* The session identified by lParam has been locked.
*/
int WTS_SESSION_LOCK = 0x7;
/**
* The session identified by lParam has been unlocked.
*/
int WTS_SESSION_UNLOCK = 0x8;
/**
* The session identified by lParam has changed its remote controlled
* status. To determine the status, call GetSystemMetrics and check the
* SM_REMOTECONTROL metric.
*/
int WTS_SESSION_REMOTE_CONTROL = 0x9;
/**
* Specifies the current server
*/
HANDLE WTS_CURRENT_SERVER_HANDLE = new HANDLE(null);
/**
* Specifies the current session (SessionId)
*/
int WTS_CURRENT_SESSION = -1;
/**
* Specifies any-session (SessionId)
*/
int WTS_ANY_SESSION = -2;
int WTS_PROCESS_INFO_LEVEL_0 = 0;
int WTS_PROCESS_INFO_LEVEL_1 = 1;
/**
* Contains extended information about a process running on a Remote Desktop
* Session Host (RD Session Host) server. This structure is returned by the
* WTSEnumerateProcessesEx function when you set the pLevel parameter to
* one.
*
* @see WTS_PROCESS_INFO_EXA
* @see WTS_PROCESS_INFO_EXW
*/
@FieldOrder({ "SessionId", "ProcessId", "pProcessName", "pUserSid", "NumberOfThreads", "HandleCount",
"PagefileUsage", "PeakPagefileUsage", "WorkingSetSize", "PeakWorkingSetSize", "UserTime", "KernelTime" })
class WTS_PROCESS_INFO_EX extends Structure {
public int SessionId;
public int ProcessId;
public String pProcessName; // Either LPSTR or LPWSTR
public PSID pUserSid;
public int NumberOfThreads;
public int HandleCount;
public int PagefileUsage;
public int PeakPagefileUsage;
public int WorkingSetSize;
public int PeakWorkingSetSize;
public LARGE_INTEGER UserTime;
public LARGE_INTEGER KernelTime;
public WTS_PROCESS_INFO_EX() {
super(W32APITypeMapper.DEFAULT);
}
public WTS_PROCESS_INFO_EX(Pointer p) {
super(p, Structure.ALIGN_DEFAULT, W32APITypeMapper.DEFAULT);
read();
}
}
/**
* Registers the specified window to receive session change notifications.
*
* @param hWnd
* [in] Handle of the window to receive session change
* notifications.
*
* @param dwFlags
* [in] Specifies which session notifications are to be received.
* This parameter can be one of the following values.
*
* @return If the function succeeds, the return value is TRUE. Otherwise, it
* is FALSE. To get extended error information, call GetLastError.
*/
boolean WTSRegisterSessionNotification(HWND hWnd, int dwFlags);
/**
* Unregisters the specified window so that it receives no further session
* change notifications.
*
* @param hWnd
* [in] Handle of the window to be unregistered from receiving
* session notifications.
*
* @return If the function succeeds, the return value is TRUE. Otherwise, it
* is FALSE. To get extended error information, call GetLastError.
*/
boolean WTSUnRegisterSessionNotification(HWND hWnd);
/**
* Retrieves information about the active processes on the specified Remote
* Desktop Session Host (RD Session Host) server or Remote Desktop
* Virtualization Host (RD Virtualization Host) server.
*
* @param hServer
* A handle to an RD Session Host server. Specify a handle opened
* by the WTSOpenServer function, or specify
* WTS_CURRENT_SERVER_HANDLE to indicate the server on which your
* application is running.
* @param pLevel
* A pointer to a DWORD variable that, on input, specifies the
* type of information to return. To return an array of
* WTS_PROCESS_INFO structures, specify zero. To return an array
* of WTS_PROCESS_INFO_EX structures, specify one. If you do not
* specify a valid value for this parameter, on output,
* WTSEnumerateProcessesEx sets this parameter to one and returns
* an error. Otherwise, on output, WTSEnumerateProcessesEx does
* not change the value of this parameter.
* @param SessionID
* The session for which to enumerate processes. To enumerate
* processes for all sessions on the server, specify
* WTS_ANY_SESSION.
* @param ppProcessInfo
* A pointer to a variable that receives a pointer to an array of
* WTS_PROCESS_INFO or WTS_PROCESS_INFO_EX structures. The type
* of structure is determined by the value passed to the pLevel
* parameter. Each structure in the array contains information
* about an active process. When you have finished using the
* array, free it by calling the WTSFreeMemoryEx function. You
* should also set the pointer to NULL.
* @param pCount
* A pointer to a variable that receives the number of structures
* returned in the buffer referenced by the ppProcessInfo
* parameter.
* @return If the function succeeds, the return value is a nonzero value. If
* the function fails, the return value is zero. To get extended
* error information, call the GetLastError function.
*/
boolean WTSEnumerateProcessesEx(HANDLE hServer, IntByReference pLevel, int SessionID,
PointerByReference ppProcessInfo, IntByReference pCount);
/**
* Frees memory that contains WTS_PROCESS_INFO_EX or WTS_SESSION_INFO_1
* structures allocated by a Remote Desktop Services function.
*
* @param WTSTypeClass
* A value of the WTS_TYPE_CLASS enumeration type that specifies
* the type of structures contained in the buffer referenced by
* the pMemory parameter.
* @param pMemory
* A pointer to the buffer to free.
* @param NumberOfEntries
* The number of elements in the buffer referenced by the pMemory
* parameter.
* @return If the function succeeds, the return value is a nonzero value. If
* the function fails, the return value is zero. To get extended
* error information, call the GetLastError function.
*/
boolean WTSFreeMemoryEx(int WTSTypeClass, Pointer pMemory, int NumberOfEntries);
}