Функция SetStdHandle
Задает дескриптор указанного стандартного устройства (стандартная входная, стандартная выходная или стандартная ошибка).
BOOL WINAPI SetStdHandle(
_In_ DWORD nStdHandle,
_In_ HANDLE hHandle
);
nStdHandle [ввод]
Стандартное устройство, для которого необходимо задать дескриптор. Этот параметр может принимать одно из указанных ниже значений.
Значение | Значение |
---|---|
STD_INPUT_HANDLE ((DWORD)-10) |
Стандартное устройство ввода. Изначально это входной буфер консоли, CONIN$ . |
STD_OUTPUT_HANDLE ((DWORD)-11) |
Стандартное выходное устройство. Изначально это активный буфер экрана консоли, CONOUT$ . |
STD_ERROR_HANDLE ((DWORD)-12) |
Устройство стандартных ошибок. Изначально это активный буфер экрана консоли, CONOUT$ . |
Примечание
Значения этих констант являются числами без знака, но определяются в файлах заголовков как приведение из числа со знаком и используют компилятор C для их преобразования к 32-разрядному значению, которое ниже максимального. При взаимодействии с этими дескрипторами на языке, который не анализирует заголовки и переопределяет константы, следует учитывать это ограничение. В качестве примера ((DWORD)-10)
— это число 4294967286
без знака.
hHandle [in]
Дескриптор стандартного устройства.
Если функция выполняется успешно, возвращается ненулевое значение.
Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Стандартные дескриптора процесса, возможно, были перенаправлены вызовом SetStdHandle, в этом случае GetStdHandle вернет перенаправленный дескриптор. Если стандартные дескрипторы были перенаправлены, можно указать значение CONIN$ в вызове функции CreateFile , чтобы получить дескриптор входного буфера консоли. Аналогичным образом можно указать значение CONOUT$, чтобы получить дескриптор активного буфера экрана консоли.
Пример см. в разделе "Создание дочернего процесса с перенаправленными входными и выходными данными".
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Верхний колонтитул | ProcessEnv.h (через Winbase.h, включая Windows.h) |
Библиотека | Kernel32.lib |
DLL-библиотеки | Kernel32.dll |