Funzione WTSEnumerateProcessesW (wtsapi32.h)

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

Sintassi

BOOL WTSEnumerateProcessesW(
  [in]  HANDLE             hServer,
  [in]  DWORD              Reserved,
  [in]  DWORD              Version,
  [out] PWTS_PROCESS_INFOW *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

   
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)

Vedi anche

WTS_PROCESS_INFO