Funzione WTSEnumerateProcessesA (wtsapi32.h)

Articolo
11/20/2024

Recupera informazioni sui processi attivi in un server Host sessione Desktop remoto (Host sessione Desktop remoto) specificato.

Sintassi

BOOL WTSEnumerateProcessesA(
  [in]  HANDLE             hServer,
  [in]  DWORD              Reserved,
  [in]  DWORD              Version,
  [out] PWTS_PROCESS_INFOA *ppProcessInfo,
  [out] DWORD              *pCount
);

Parametri

[in] hServer

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

[in] Reserved

Riservato; deve essere zero.

[in] Version

Specifica la versione della richiesta di enumerazione. Deve essere 1.

[out] ppProcessInfo

Puntatore a una variabile che riceve un puntatore a una matrice di strutture WTS_PROCESS_INFO. Ogni struttura nella matrice contiene informazioni su un processo attivo nel server Host sessione Desktop remoto specificato. Per liberare il buffer restituito, chiamare la funzione WTSFreeMemory .

[out] pCount

Puntatore a una variabile che riceve il numero di strutture WTS_PROCESS_INFO restituite nel buffer 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 GetLastError.

Osservazioni

Il chiamante deve essere membro del gruppo Administrators per enumerare i processi in esecuzione nel contesto di un utente diverso.

Nota

L'intestazione wtsapi32.h definisce WTSEnumerateProcesses 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 Vista
server minimo supportato	Windows Server 2008
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

WTS_PROCESS_INFO

Condividi tramite