Funzione GetConsoleProcessList

Recupera un elenco dei processi collegati alla console corrente.

Sintassi

DWORD WINAPI GetConsoleProcessList(
  _Out_ LPDWORD lpdwProcessList,
  _In_  DWORD   dwProcessCount
);

Parametri

lpdwProcessList [out]
Puntatore a un buffer che riceve una matrice di identificatori di processo in caso di esito positivo. Deve essere un buffer valido e non può essere NULL. Il buffer deve avere spazio per ricevere almeno 1 ID processo restituito.

dwProcessCount [in]
Numero massimo di identificatori di processo che possono essere archiviati nel buffer lpdwProcessList . Deve essere maggiore di 0.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è minore o uguale a dwProcessCount e rappresenta il numero di identificatori di processo archiviati nel buffer lpdwProcessList .

Se il buffer è troppo piccolo per contenere tutti gli identificatori di processo validi, il valore restituito è il numero richiesto di elementi della matrice. La funzione non avrà archiviato identificatori nel buffer. In questo caso, usare il valore restituito per allocare un buffer sufficientemente grande da archiviare l'intero elenco e chiamare di nuovo la funzione.

Se il valore restituito è zero, la funzione non è riuscita perché a ogni console è associato almeno un processo. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Se è stato specificato un NULL elenco di processi o il numero di processi è 0, la chiamata restituirà 0 e GetLastError restituirà ERROR_INVALID_PARAMETER. Specificare un buffer di almeno un elemento per chiamare questa funzione. Allocare un buffer più grande e chiamare di nuovo se il codice restituito è maggiore della lunghezza del buffer fornito.

Osservazioni:

Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0501 o versione successiva. Per altre informazioni, vedere Uso delle intestazioni di Windows.

Suggerimento

Questa API non è consigliata e non ha un terminale virtuale equivalente. Questa decisione allinea intenzionalmente la piattaforma Windows ad altri sistemi operativi. Questo stato è rilevante solo per l'utente, la sessione e il contesto dei privilegi locali. Le applicazioni remote tramite utilità multipiattaforma e trasporti come SSH potrebbero non funzionare come previsto se si usa questa API.

Requisiti

Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	ConsoleApi3.h (tramite WinCon.h, includere Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedi anche

AttachConsole

Funzioni della console