Função SetStdHandle
Define o identificador para o dispositivo padrão especificado (entrada padrão, saída padrão ou erro padrão).
BOOL WINAPI SetStdHandle(
_In_ DWORD nStdHandle,
_In_ HANDLE hHandle
);
nStdHandle [in]
O dispositivo padrão cuja alça deve ser definida. Esse parâmetro pode usar um dos valores a seguir.
| Valor | Significado |
|---|---|
STD_INPUT_HANDLE ((DWORD)-10) |
O dispositivo de entrada padrão. Inicialmente, esse é o buffer de entrada do console, CONIN$. |
STD_OUTPUT_HANDLE ((DWORD)-11) |
O dispositivo de saída padrão. Inicialmente, esse é o buffer de tela do console ativo, CONOUT$. |
STD_ERROR_HANDLE ((DWORD)-12) |
O dispositivo de erro padrão. Inicialmente, esse é o buffer de tela do console ativo, CONOUT$. |
Observação
Os valores dessas constantes são números não assinados, mas são definidos nos arquivos de cabeçalho como uma conversão de um número assinado e aproveitam o compilador C, substituindo-os para ficarem abaixo do valor máximo de 32 bits. Ao fazer a interface com esses identificadores em uma linguagem que não analisa os cabeçalhos e está redefinindo as constantes, esteja ciente dessa restrição. Por exemplo, ((DWORD)-10) é, na verdade, o número não assinado 4294967286.
hHandle [entrada]
A alça do dispositivo padrão.
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Os identificadores padrão de um processo podem ser redirecionados por uma chamada para SetStdHandle. Nesse caso, GetStdHandle retornará o identificador redirecionado. Se os identificadores padrão tiverem sido redirecionados, você poderá especificar o valor CONIN$ em uma chamada para a função CreateFile para obter um identificador para o buffer de entrada de um console. Da mesma forma, você pode especificar o valor CONOUT$ para obter o identificador para o buffer de tela ativo de um console.
Para obter uma exemplo, consulte Criar um processo filho com entrada e saída redirecionadas.
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos para desktop] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho | ProcessEnv.h (por meio de Winbase.h, incluir Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |