Función WTSEnumerateProcessesExW (wtsapi32.h)

Recupera información sobre los procesos activos en el servidor de host de sesión de Escritorio remoto (host de sesión de Escritorio remoto) especificado o en el servidor host de virtualización de Escritorio remoto (host de virtualización de Escritorio remoto).

Sintaxis

BOOL WTSEnumerateProcessesExW(
  [in]      HANDLE hServer,
  [in, out] DWORD  *pLevel,
  [in]      DWORD  SessionId,
  [out]     LPWSTR *ppProcessInfo,
  [out]     DWORD  *pCount
);

Parámetros

[in] hServer

Identificador de un servidor host de sesión de Escritorio remoto. Especifique un identificador abierto por la función WTSOpenServer o especifique WTS_CURRENT_SERVER_HANDLE para indicar el servidor en el que se ejecuta la aplicación.

[in, out] pLevel

Puntero a una DWORD variable que, en la entrada, especifica el tipo de información que se va a devolver. Para devolver una matriz de estructuras de WTS_PROCESS_INFO, especifique cero. Para devolver una matriz de estructuras de WTS_PROCESS_INFO_EX, especifique una.

Si no especifica un valor válido para este parámetro, en la salida, WTSEnumerateProcessesEx establece este parámetro en uno y devuelve un error. De lo contrario, en la salida, WTSEnumerateProcessesEx no cambia el valor de este parámetro.

[in] SessionId

Sesión para la que se van a enumerar los procesos. Para enumerar los procesos de todas las sesiones del servidor, especifique WTS_ANY_SESSION.

[out] ppProcessInfo

Puntero a una variable que recibe un puntero a una matriz de estructuras WTS_PROCESS_INFO o WTS_PROCESS_INFO_EX. El tipo de estructura viene determinado por el valor pasado al parámetro pLevel. Cada estructura de la matriz contiene información sobre un proceso activo. Cuando haya terminado de usar la matriz, puede liberarla llamando a la función WTSFreeMemoryEx. También debe establecer el puntero en NULL.

[out] pCount

Puntero a una variable que recibe el número de
estructuras devueltas en el búfer al que hace referencia el parámetro ppProcessInfo.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero.

Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a la función GetLastError.

Observaciones

El autor de la llamada debe ser miembro del grupo Administradores para enumerar los procesos que se ejecutan en otra sesión de usuario.

Nota

El encabezado wtsapi32.h define WTSEnumerateProcessesEx como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 7
servidor mínimo admitido	Windows Server 2008 R2
de la plataforma de destino de	Windows
encabezado de	wtsapi32.h
biblioteca de	Wtsapi32.lib
DLL de	Wtsapi32.dll
conjunto de API de	ext-ms-win-session-wtsapi32-l1-1-0 (introducido en Windows 8)

Consulte también

WTSOpenServer

WTS_PROCESS_INFO

WTS_PROCESS_INFO_EX