Funzione WTSEnumerateProcessesA (wtsapi32.h)
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
Riservati; 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 della 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 informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
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 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 Vista |
Server minimo supportato | Windows Server 2008 |
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) |