Функция
SetStdHandleФункция
SetStdHandle устанавливает дескриптор для устройств стандартного ввода данных, стандартного вывода данных или обработки стандартной ошибки.Синтаксис
nStdHandle , // устройство ввода, вывода // или обработки ошибки HANDLE hHandle // дескриптор ); |
Параметры
nStdHandle
[in] Стандартное устройство, для которого будет установлен дескриптор. Этот параметр может быть одним из следующих значений.
|
Значение |
Предназначение |
|
STD_INPUT_HANDLE |
Дескриптор устройства стандартного ввода данных. |
|
STD_OUTPUT_HANDLE |
Дескриптор устройства стандартного вывода данных. |
|
STD_ERROR_HANDLE |
Дескриптор устройства стандартной обработки ошибки. |
hHandle
[in] Дескриптор, который устанавливается для заданного устройства.
Возвращаемые значения
Если функция завершается успешно, величина возвращаемого значения - не ноль.
Если функция завершается с ошибкой, величина возвращаемого значения - ноль. Чтобы получать расширенные данные об ошибках, вызовите функцию
GetLastError.Замечания
Стандартные дескрипторы процесса можно переназначить при помощи вызова функции SetStdHandle, в этом случае функция
GetStdHandle возвратит переназначенный дескриптор. Если стандартные дескрипторы были переназначены, при вызове к функции CreateFile Вы можете установить значение CONIN$, чтобы получить дескриптор для буфера ввода консоли. Точно так же Вы можете установить значение CONOUT$, чтобы получить дескриптор для активного экранного буфера консоли.Код примера
Пример смотри в статье
Создание дочернего процесса с переназначением ввода и вывода данных.Смотри также
Обзор консольных приложений, Функции консоли, CreateFile, GetStdHandle
|
Размещение и совместимость SetStdHandle |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
Kernel32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Wincon.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |