Funzione SetStdHandle

Imposta l'handle per il dispositivo standard specificato (input standard, output standard o errore standard).

Sintassi

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

Parametri

nStdHandle [in]
Dispositivo standard per il quale deve essere impostato l'handle. Questo parametro può avere uno dei valori seguenti.

valore	Significato
STD_INPUT_HANDLE((DWORD)-10)	Il dispositivo di input standard. Inizialmente si tratta del buffer di input della console, ovvero CONIN$.
STD_OUTPUT_HANDLE((DWORD)-11)	Il dispositivo di output standard. Inizialmente si tratta del buffer dello schermo della console attivo, ovvero CONOUT$.
STD_ERROR_HANDLE((DWORD)-12)	Il dispositivo di errore standard. Inizialmente si tratta del buffer dello schermo della console attivo, ovvero CONOUT$.

Nota

I valori per queste costanti sono numeri senza segno, ma sono definiti nei file di intestazione come cast da un numero con segno e sfruttano il rollover del compilatore C fino al valore massimo a 32 bit. Quando si interagisce con questi handle in un linguaggio che non analizza le intestazioni e ridefinisce le costanti, tenere presente questo vincolo. Ad esempio, ((DWORD)-10) è in realtà il numero 4294967286senza segno .

hHandle [in]
Handle per il dispositivo standard.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Osservazioni:

Gli handle standard di un processo potrebbero essere stati reindirizzati da una chiamata a SetStdHandle, nel qual caso GetStdHandle restituirà l'handle reindirizzato. Se gli handle standard sono stati reindirizzati, è possibile specificare il valore CONIN$ in una chiamata alla funzione CreateFile per ottenere un handle nel buffer di input di una console. Analogamente, è possibile specificare il valore CONOUT$ per ottenere un handle nel buffer dello schermo attivo della console.

Esempi

Per un esempio, vedere Creazione di un processo figlio con input e output reindirizzati.

Requisiti

Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	ProcessEnv.h (tramite Winbase.h, con Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedi anche

Funzioni della console

Handle della console

CreateFile

GetStdHandle