_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

_get_doserrno ist eine Microsoft-Erweiterung. Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Siehe auch

_set_doserrno
errno, _doserrno, _sys_errlist und _sys_nerr