Funzione WTSEnumerateProcessesA (wtsapi32.h)

  • Articolo

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)

Vedi anche

WTS_PROCESS_INFO