SetStdHandle 函数
设置用于指定的标准设备的句柄(标准输入、标准输出或标准错误)。
BOOL WINAPI SetStdHandle(
_In_ DWORD nStdHandle,
_In_ HANDLE hHandle
);
nStdHandle [in]
要为其设置句柄的标准设备。 此参数的取值可为下列值之一。
值 | 含义 |
---|---|
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 将返回重定向的句柄。 如果已重定向标准句柄,则可在对 CreateFile 函数的调用中指定 CONIN$ 值,以获取控制台输入缓冲区的句柄。 同样,你也可指定 CONOUT$ 值来获取控制台的活动屏幕缓冲区的句柄。
有关示例,请参阅使用重定向输入和输出创建子进程。
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
头文件 | ProcessEnv.h (via Winbase.h, include Windows.h) |
库 | Kernel32.lib |
DLL | Kernel32.dll |