Функция SetStdHandle

Статья
12/13/2023

Задает дескриптор указанного стандартного устройства (стандартная входная, стандартная выходная или стандартная ошибка).

Синтаксис

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$, чтобы получить дескриптор активного буфера экрана консоли.

Примеры

Пример см. в разделе "Создание дочернего процесса с перенаправленными входными и выходными данными".

Requirements


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Верхний колонтитул	ProcessEnv.h (через Winbase.h, включая Windows.h)
Библиотека	Kernel32.lib
DLL-библиотеки	Kernel32.dll

См. также