Функция GetConsoleProcessList


Функция GetConsoleProcessList извлекает перечень процессов, связанных с текущей консолью.

Синтаксис

DWORD GetConsoleProcessList(

LPDWORD lpdwProcessList ,
DWORD
dwProcessCount

);

Параметры

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

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz