Funzione WTSEnumerateProcessesExA (wtsapi32.h)

Articolo
03/04/2024

Recupera informazioni sui processi attivi nel server Host sessione Desktop remoto (Host sessione Desktop remoto) o nel server Host sessione Desktop remoto (Rd Virtualization Host).

Sintassi

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

Parametri

[in] hServer

Handle per un server Host sessione Desktop remoto. Specificare un handle aperto dalla funzione WTSOpenServer oppure specificare WTS_CURRENT_SERVER_HANDLE per indicare il server in cui è in esecuzione l'applicazione.

[in, out] pLevel

Puntatore a una variabile DWORD che, all'input, specifica il tipo di informazioni da restituire. Per restituire una matrice di strutture WTS_PROCESS_INFO , specificare zero. Per restituire una matrice di strutture WTS_PROCESS_INFO_EX , specificarne una.

Se non si specifica un valore valido per questo parametro, nell'output WTSEnumerateProcessesEx imposta questo parametro su uno e restituisce un errore. In caso contrario, nell'output WTSEnumerateProcessesEx non viene modificato il valore di questo parametro.

[in] SessionId

Sessione per la quale enumerare i processi. Per enumerare i processi per tutte le sessioni nel server, specificare WTS_ANY_SESSION.

[out] ppProcessInfo

Puntatore a una variabile che riceve un puntatore a una matrice di strutture WTS_PROCESS_INFO o WTS_PROCESS_INFO_EX . Il tipo di struttura è determinato dal valore passato al parametro pLevel . Ogni struttura nella matrice contiene informazioni su un processo attivo. Al termine dell'uso della matrice, liberarlo chiamando la funzione WTSFreeMemoryEx . È anche necessario impostare il puntatore su NULL.

[out] pCount

Puntatore a una variabile che riceve il numero di
strutture restituite nel buffer a cui fa riferimento il parametro ppProcessInfo .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni sull'errore estese, chiamare la funzione GetLastError .

Commenti

Il chiamante deve essere membro del gruppo Administrators per enumerare i processi in esecuzione in un'altra sessione utente.

Nota

L'intestazione wtsapi32.h definisce WTSEnumerateProcessesEx come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7
Server minimo supportato	Windows Server 2008 R2
Piattaforma di destinazione	Windows
Intestazione	wtsapi32.h
Libreria	Wtsapi32.lib
DLL	Wtsapi32.dll
Set di API	ext-ms-win-session-wtsapi32-l1-1-0 (introdotto in Windows 8)

Vedi anche

WTSOpenServer

WTS_PROCESS_INFO

WTS_PROCESS_INFO_EX

Condividi tramite