SetStdHandle-Funktion

  • Artikel

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

Siehe auch

Konsolenfunktionen

Konsolenhandles

CreateFile

GetStdHandle