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 |
| DLL | Kernel32.dll |