Fonction SetStdHandle
Définit un handle vers l’appareil standard spécifié (entrée standard, sortie standard ou erreur standard).
BOOL WINAPI SetStdHandle(
_In_ DWORD nStdHandle,
_In_ HANDLE hHandle
);
nStdHandle [entrée]
Appareil standard pour lequel le handle doit être défini. Ce paramètre peut prendre les valeurs suivantes.
Valeur | Signification |
---|---|
STD_INPUT_HANDLE ((DWORD)-10) |
Périphérique d’entrée standard. À la base, il s’agit de la mémoire tampon d’entrée de la console, CONIN$ . |
STD_OUTPUT_HANDLE ((DWORD)-11) |
Périphérique de sortie standard. À la base, il s’agit de la mémoire tampon d’écran de la console active, CONOUT$ . |
STD_ERROR_HANDLE ((DWORD)-12) |
Périphérique d’erreur standard. À la base, il s’agit de la mémoire tampon d’écran de la console active, CONOUT$ . |
Notes
Bien que les valeurs de ces constantes soient des nombres non signés, elles sont définies dans les fichiers d’en-tête en tant que cast d’un nombre signé et tirent parti du compilateur C qui les fait passer juste en dessous de la valeur maximale de 32 bits. En cas d’interfaçage avec ces handles dans un langage qui n’analyse pas les en-têtes et qui redéfinit les constantes, tenez compte de cette contrainte. Par exemple, ((DWORD)-10)
est en fait le nombre non signé 4294967286
.
hHandle [entrée]
Handle pour l’appareil standard.
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Les handles standard d’un processus peuvent avoir été redirigés par un appel à SetStdHandle, auquel cas GetStdHandle retournera le handle redirigé. Si les handles standard ont été redirigés, vous pouvez spécifier la valeur CONIN$ dans un appel à la fonction CreateFile pour obtenir un handle vers la mémoire tampon d’entrée d’une console. De même, vous pouvez spécifier la valeur CONOUT$ pour obtenir un handle vers la mémoire tampon d’écran active d’une console.
Pour obtenir un exemple, consultez Création d’un processus enfant avec une entrée et une sortie redirigées.
Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
En-tête | ProcessEnv.h (via Winbase.h, inclure Windows.h) |
Bibliothèque | Kernel32.lib |
DLL | Kernel32.dll |