_get_doserrno
Ruft den vom Betriebssystem zurückgegebenen Fehlerwert ab, bevor er in einen errno Wert übersetzt wird.
Syntax
errno_t _get_doserrno(
int * pValue
);
Parameter
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 NULLannimmt, wird der Handler für ungültige Parameter aufgerufen, wie in Parameter Validation. 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. Er wird auf den Von einem Funktionsaufruf auf Systemebene zurückgegebenen Betriebssystemfehlerwert festgelegt, der einen Betriebssystemfehler zurückgibt und während der Ausführung niemals auf Null zurückgesetzt wird. Wenn Sie Code schreiben, um den von einer Funktion zurückgegebenen Fehlerwert zu überprüfen, deaktivieren Sie immer _doserrno die Verwendung vor _set_doserrno dem Funktionsaufruf. Da eine andere Funktion _doserrno überschreiben könnte, prüfen Sie unmittelbar nach dem Funktionsaufruf den Wert durch Anwendung von _get_doserrno.
Wir empfehlen _get_errno anstelle von _get_doserrno portablen Fehlercodes.
Mögliche Werte sind _doserrno in <errno.h> definiert.
Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.
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.