_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. Ist pValue dies NULLder Fehler, wird der ungültige Parameterhandler aufgerufen, wie in der Parameterüberprüfung beschrieben. 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. Informationen zum Ändern dieses Verhaltens finden Sie im Global state in the 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.

Siehe auch

_set_doserrno
errno, _doserrno, _sys_errlist und _sys_nerr