Función SetStdHandle

Establece el identificador para el dispositivo estándar especificado (entrada estándar, salida estándar o error estándar).

Sintaxis

BOOL WINAPI SetStdHandle(
  _In_ DWORD  nStdHandle,
  _In_ HANDLE hHandle
);

Parámetros

nStdHandle [in]
El dispositivo estándar para el que se va a establecer el identificador. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
STD_INPUT_HANDLE((DWORD)-10)	El dispositivo de entrada estándar. Inicialmente, es el búfer de entrada de la consola, CONIN$.
STD_OUTPUT_HANDLE((DWORD)-11)	El dispositivo de salida estándar. Inicialmente, es el búfer de pantalla activo de la consola, CONOUT$.
STD_ERROR_HANDLE((DWORD)-12)	El dispositivo de error estándar. Inicialmente, es el búfer de pantalla activo de la consola, CONOUT$.

Nota:

Los valores de estas constantes son números sin signo, pero se definen en los archivos de encabezado como una conversión a partir de un número con signo, y aprovechan que el compilador de C los sustituye por algo inferior al valor máximo de 32 bits. Al interactuar con estos identificadores en un lenguaje que no analiza los encabezados y vuelve a definir las constantes, tenga en cuenta esta restricción. Por ejemplo, ((DWORD)-10) en realidad es el número sin signo 4294967286.

hHandle [in]
El identificador del dispositivo estándar.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Los identificadores estándar de un proceso se pueden haber redirigido mediante una llamada a SetStdHandle, en cuyo caso GetStdHandle devolverá el identificador redirigido. Si se han redirigido los identificadores estándar, puede especificar el valor CONIN$ en una llamada a la función CreateFile para obtener un identificador del búfer de entrada de la consola. De forma similar, puede especificar el valor CONOUT$ para obtener un identificador para el búfer de pantalla activo de la consola.

Ejemplos

Para ver un ejemplo, consulte Creación de un proceso secundario con entrada y salida redirigidas.

Requisitos

Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	ProcessEnv.h (via Winbase.h, include Windows.h)
Biblioteca	Kernel32.lib
Archivo DLL	Kernel32.dll

Consulte también

Funciones de la consola

Identificadores de consola

CreateFile

GetStdHandle