Funzione WTSEnumerateProcessesExA (wtsapi32.h)

Articolo
11/20/2024

Recupera informazioni sui processi attivi nel server Host sessione Desktop remoto (Host sessione Desktop remoto) o sul server Host di virtualizzazione 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 un DWORD variabile che, in input, specifica il tipo di informazioni da restituire. Per restituire una matrice di strutture di 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 modifica 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, liberarla 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 estese sull'errore, chiamare la funzione GetLastError .

Osservazioni

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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 7
server minimo supportato	Windows Server 2008 R2
piattaforma di destinazione	Finestre
intestazione	wtsapi32.h
libreria	Wtsapi32.lib
dll	Wtsapi32.dll
set di API	ext-ms-win-session-wtsapi32-l1-1-0 (introdotto in Windows 8)

Vedere anche

WTSOpenServer

WTS_PROCESS_INFO

WTS_PROCESS_INFO_EX

Condividi tramite