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