Fonction SetStdHandle

Article
12/15/2023

Définit un handle vers l’appareil standard spécifié (entrée standard, sortie standard ou erreur standard).

Syntaxe

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

Paramètres

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$`.

Remarque

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.

Valeur retournée

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.

Notes

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.

Exemples

Pour obtenir un exemple, consultez Création d’un processus enfant avec une entrée et une sortie redirigées.

Spécifications


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

Voir aussi