The WTSEnumerateProcesses function retrieves information about the active processes on a specified Remote Desktop Session Host (RD Session Host) server.

Syntax

BOOL WTSEnumerateProcesses(
  __in   HANDLE hServer,
  __in   DWORD Reserved,
  __in   DWORD Version,
  __out  PWTS_PROCESS_INFO *ppProcessInfo,
  __out  DWORD *pCount
);

Parameters

hServer [in]

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 [in]

Reserved; must be zero.

Version [in]

Specifies the version of the enumeration request. Must be 1.

ppProcessInfo [out]

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 [out]

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

See Also

WTS_PROCESS_INFO

Send comments about this topic to Microsoft

Build date: 10/19/2009