SetStdHandle-Funktion
Legt das Handle für das angegebene Standardgerät fest (Standardeingabe, Standardausgabe oder Standardfehler).
Syntax
BOOL WINAPI SetStdHandle(
_In_ DWORD nStdHandle,
_In_ HANDLE hHandle
);
Parameter
nStdHandle [in]
Das Standardgerät, für das das Handle festgelegt werden soll. Dieser Parameter kann einen der folgenden Werte annehmen.
| Wert | Bedeutung |
|---|---|
STD_INPUT_HANDLE ((DWORD)-10) |
Das Standardeingabegerät. Anfänglich ist dies der Konsoleneingabepuffer, CONIN$. |
STD_OUTPUT_HANDLE ((DWORD)-11) |
Das Standardausgabegerät. Anfänglich ist dies der aktive Konsolenbildschirmpuffer, CONOUT$. |
STD_ERROR_HANDLE ((DWORD)-12) |
Das Standardfehlergerät. Anfänglich ist dies der aktive Konsolenbildschirmpuffer, CONOUT$. |
Hinweis
Die Werte für diese Konstanten sind vorzeichenlose Zahlen, werden aber in den Headerdateien als Cast aus einer Zahl mit Vorzeichen definiert und profitieren davon, dass der C-Compiler ein Rollover auf einen Wert knapp unter dem maximalen 32-Bit-Wert vornimmt. Beachten Sie diese Einschränkung beim Herstellen einer Schnittstelle mit diesen Handles in einer Sprache, die die Header nicht analysiert und die Konstanten neu definiert. Beispielsweise ist ((DWORD)-10) tatsächlich die Zahl 4294967286 ohne Vorzeichen.
hHandle [in]
Das Handle für das Standardgerät.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Die Standardhandles eines Prozesses könnten durch einen Aufruf von SetStdHandle umgeleitet worden sein. In diesem Fall gibt GetStdHandle das umgeleitete Handle zurück. Wenn die Standardhandles umgeleitet wurden, können Sie den CONIN$-Wert in einem Aufruf der Funktion CreateFile angeben, um ein Handle zum Eingabespeicher einer Konsole abzurufen. In ähnlicher Weise können Sie den CONOUT$-Wert angeben, um ein Handle für den aktiven Bildschirmpuffer der Konsole abzurufen.
Beispiele
Für ein Beispiel siehe Erstellen eines untergeordneten Prozesses mit umgeleiteter Eingabe und Ausgabe.
Anforderungen
| Unterstützte Mindestversion Client | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Header | ProcessEnv.h (via Winbase.h, include Windows.h) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |