WTSEnumerateProcessesA function
Retrieves information about the active processes on a specified Remote Desktop Session Host (RD Session Host) server.
Syntax
BOOL WTSEnumerateProcessesA(
IN HANDLE hServer,
IN DWORD Reserved,
IN DWORD Version,
OUT PWTS_PROCESS_INFOA *ppProcessInfo,
OUT DWORD *pCount
);
Parameters
hServer
Handle to an RD Session Host server. Specify a handle opened by the WTSOpenServer function, or specify WTS_CURRENT_SERVER_HANDLE to indicate the RD Session Host server on which your application is running.
Reserved
Reserved; must be zero.
Version
Specifies the version of the enumeration request. Must be 1.
ppProcessInfo
Pointer to a variable that receives a pointer to an array of WTS_PROCESS_INFO structures. Each structure in the array contains information about an active process on the specified RD Session Host server. To free the returned buffer, call the WTSFreeMemory function.
pCount
Pointer to a variable that receives the number of WTS_PROCESS_INFO structures returned in the ppProcessInfo buffer.
Return Value
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 GetLastError.
Remarks
The caller must be a member of the Administrators group to enumerate processes that are running under a different user's context.
Requirements
Minimum supported client | Windows Vista |
Minimum supported server | Windows Server 2008 |
Target Platform | Windows |
Header | wtsapi32.h |
Library | Wtsapi32.lib |
DLL | Wtsapi32.dll |