GetConsoleProcessList

Składnia

Argumenty

Argument	Opis
lpdwProcessList	Wskaźnik do bufora pobierającego tablicę identyfikatorów procesów. Pamięć do przechowywania danych tego bufora jest alokowana na stercie dla procesu, którego rozmiar wynosi 64 KB. Maksymalny rozmiar bufora zależy od użycia sterty.
dwProcessCount	Maksymalna liczba identyfikatorów procesów, która może być przechowywana w buforze wskazywanym przez argument lpdwProcessList.

Zwracana wartość

Jeśli nie wystąpią żadne błędy, zwracana wartość jest mniejsza lub równa wartości argumentu dwProcessCount i określa liczbę identyfikatorów procesów przechowywanych w buforze wskazywanym przez argument lpdwProcessList. Jeśli bufor jest za mały aby zmieścić wszystkie identyfikatory procesów, zwracaną wartością jest wymagana liczba elementów bufora. W tym przypadku funkcja nie umieszcza żadnych identyfikatorów w buforze. Programista może użyć zwracanej wartości do zaalokowania bufora, który pomieści wszystkie dane z tej listy i wywołać tą funkcję ponownie. Jeśli zwracaną wartością jest zero, wystąpił błąd, ponieważ każda konsola ma co najmniej jeden proces, który jest z nią powiązany. Aby uzyskać rozszerzone informacje o błędach, wywołaj funkcję _{» WinAPI ♦} GetLastError.

Dodatkowe informacje

Aby skompilować program używający tej funkcji, stała _WIN32_WINNT musi mieć wartość większą lub równą 0x0501.

Wymagania

Minimalny system klienta	Windows XP (tylko aplikacje biurowe).
Minimalny system serwera	Windows Server 2003 (tylko aplikacje biurowe).
Nagłówek	Wincon.h (dołącza Windows.h)
Biblioteka	Kernel32.lib
DLL	Kernel32.dll

Linki zewnętrzne

• http://msdn.microsoft.com/en-us/library/windows/desktop/ms683170(v=vs.85).aspx