Funzione SetStdHandle
Imposta l'handle per il dispositivo standard specificato (input standard, output standard o errore standard).
BOOL WINAPI SetStdHandle(
_In_ DWORD nStdHandle,
_In_ HANDLE hHandle
);
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 4294967286
senza segno .
hHandle [in]
Handle per il dispositivo standard.
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.
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.
Per un esempio, vedere Creazione di un processo figlio con input e output reindirizzati.
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) |
Library | Kernel32.lib |
DLL | Kernel32.dll |