Функция
GetConsoleProcessListФункция
GetConsoleProcessList извлекает перечень процессов, связанных с текущей консолью.Синтаксис
GetConsoleProcessList(
); |
Параметры
pdwProcessList
[out] Указатель на буфер, который принимает массив идентификаторов процесса. Общий размер требуемого буфера вывода, должен быть меньше чем 64КБ.
dwProcessCount
[in] Максимальное число идентификаторов процесса, которые могут быть сохранены в
буфере lpdwProcessList.Возвращаемые значения
Возвращаемое значение равно числу процессов, которые подключены к текущей консоли.
Если возвращаемое значение меньше чем или равно
dwProcessCount, оно к тому же и число идентификаторов процесса, сохраненных в буфере lpdwProcessList.Если возвращаемое значение большее чем
dwProcessCount, буфер lpdwProcessList слишком маленький, чтобы вместить все правильные идентификаторы процесса. Функция не сохраняет идентификаторы в этом буфере. В этой ситуации используйте возвращаемое значение, чтобы назначить буфер, который является достаточно большим для сохранения перечня полностью и вызовите функцию снова.Если величина возвращаемого значения - ноль, функция завершилась ошибкой, потому что каждая консоль имеет, по крайней мере, один процесс, связанный с ней. Чтобы получать расширенные данные об ошибках, вызовите функцию
GetLastError.Замечания
Чтобы компилировать приложение, которое использует эту функцию, определите макрокоманду
_WIN32_WINNT как 0x0501 или выше. Для получения дополнительной информации, см. статью Использование заголовочных файлов SDK.Смотри
такжеОбзор консольных приложений, Функции консоли, AttachConsole
Размещение и совместимость GetConsoleProcessList |
|
Windows. NET Server |
Да |
Windows XP |
Да |
Windows 2000 |
Да |
Windows NT |
Нет |
Windows Me |
Нет |
Windows 98 |
Нет |
Windows 95 |
Нет |
Используемая библиотека |
Kernel32.lib |
Заголовочный файл |
|
- объявлено в |
Wincon.h |
- включено в |
Windows.h |
Unicode |
Нет |
Замечания по платформе |
Не имеется |