Функция SetStdHandle


Функция SetStdHandle устанавливает дескриптор для устройств стандартного ввода данных, стандартного вывода данных или обработки стандартной ошибки.

Синтаксис

BOOL SetStdHandle(

DWORD 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

Нет

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

Не имеется

 

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

Hosted by uCoz