_get_doserrno
Ruft den vom Betriebssystem zurückgegebenen Fehlerwert ab, bevor dieser in einen errno-Wert übersetzt wird.
errno_t _get_doserrno( int * pValue );
Parameter
- [out] pValue
Ein Zeiger auf eine Ganzzahl, die durch den aktuellen Wert des globalen Makros _doserrno ersetzt werden soll.
Rückgabewert
Wenn _get_doserrno erfolgreich verläuft, gibt es 0 zurück, andernfalls einen Fehlercode. Wenn pValue den Wert NULL annimmt, wird der ungültige Parameterhandler, wie in Parametervalidierung beschrieben, aufgerufen. Wenn die weitere Ausführung zugelassen wird, legt diese Funktion errno auf EINVAL fest und gibt EINVAL zurück.
Hinweise
Das globale Makro _doserrno wird bei der CRT-Initialisierung auf Null gesetzt, bevor die Prozessausführung beginnt. Es wird auf einen Betriebssystemfehlerwert gesetzt, der von jeder Funktion auf Systemebene zurückgegeben wird, die einen Betriebssystemfehler zurückgibt, und wird während der Ausführung niemals auf Null gesetzt. Wenn Sie Code schreiben, um den von einer Funktion zurückgegebenen Fehlerwert zu prüfen, löschen Sie vor dem Funktionsaufruf immer _doserrno durch Anwendung von _set_doserrno. Da eine andere Funktion _doserrno überschreiben könnte, prüfen Sie unmittelbar nach dem Funktionsaufruf den Wert durch Anwendung von _get_doserrno.
Für übertragbare Fehlercodes wird _get_errno statt _get_doserrno empfohlen.
Mögliche Werte von _doserrno sind in <errno.h> definiert.
Anforderungen
Routine |
Erforderlicher Header |
Optionaler Header |
|---|---|---|
_get_doserrno |
<stdlib.h>, <cstdlib> (C++) |
<errno.h>, <cerrno> (C++) |
_get_doserrno ist eine Microsoft-Erweiterung. Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.