Função SetStdHandle
Define o identificador para o dispositivo padrão especificado (entrada padrão, saída padrão ou erro padrão).
Sintaxe
BOOL WINAPI SetStdHandle(
_In_ DWORD nStdHandle,
_In_ HANDLE hHandle
);
Parâmetros
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.
Valor retornado
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.
Comentários
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.
Exemplos
Para obter uma exemplo, consulte Criar um processo filho com entrada e saída redirecionadas.
Requisitos
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 |