Lire en anglais

Partager via


Fonction SetStdHandle

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

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.

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

Fonctions de console

descripteur de console

CreateFile

GetStdHandle