Função SetStdHandle

  • Artigo

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 da área de trabalho]
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

Confira também

Funções de Console

Identificadores do console

CreateFile

GetStdHandle