_get_doserrno
Recupera il valore di errore restituito dal sistema operativo prima che venga convertito in un valore errno.
errno_t _get_doserrno( int * pValue );
Parametri
- [out] pValue
Un puntatore a un valore integer che deve essere compilato con il valore corrente della macro globale _doserrno.
Valore restituito
Se _get_doserrno ha esito positivo, restituisce zero; in caso contrario, restituisce un codice di errore. Se pValue è NULL, verrà richiamato il gestore di parametro non valido, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, la funzione imposta errno suEINVAL e restituisce EINVAL.
Note
La macro globale _doserrno è impostata su zero durante l'inizializzazione CRT, prima dell'inizio dell'esecuzione del processo. È impostata sul valore di errore del sistema operativo restituito da qualsiasi chiamata di funzione a livello del sistema che restituisce un errore del sistema operativo e non viene mai reimpostata su zero durante l'esecuzione. Quando si scrive il codice per il controllo del valore di errore restituito da una funzione, deselezionare sempre _doserrno usando _set_doserrno prima della chiamata di funzione. Poiché un'altra chiamata di funzione potrebbe sovrascrivere _doserrno, verificare il valore usando _get_doserrno immediatamente dopo la chiamata di funzione.
È consigliabile usare _get_errno invece di _get_doserrno per i codici di errore portabili.
I valori possibili di _doserrno sono definiti in <errno.h>.
Requisiti
Routine |
Intestazione obbligatoria |
Intestazione facoltativa |
|---|---|---|
_get_doserrno |
<stdlib.h>, <cstdlib> (C++) |
<errno.h>, <cerrno> (C++) |
_get_doserrno è un'estensione Microsoft. Per altre informazioni sulla compatibilità, vedere Compatibilità.