RtlIntToUInt8-Funktion (ntintsafe.h)

Konvertiert einen Wert vom Typ INT in einen Wert vom Typ UINT8.

Syntax

NTSTATUS RtlIntToUInt8(
  [in]  INT   iOperand,
  [out] UINT8 *pui8Result
);

Parameter

[in] iOperand

Der zu konvertierende Wert.

[out] pui8Result

Ein Zeiger auf den konvertierten Wert. Wenn die Konvertierung eine Abschneidung des ursprünglichen Werts verursacht, gibt die Funktion STATUS_INTEGER_OVERFLOW zurück, und dieser Parameter ist ungültig.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist.

Mögliche Fehlerrückgabewerte finden Sie in der Implementierung dieser Hilfsfunktion im ntintsafe.h WDK.

Hinweise

Dies ist eine von einer Reihe von Inlinefunktionen, die für die Bereitstellung von Typkonvertierungen und die Durchführung von Gültigkeitsprüfungen mit minimalen Auswirkungen auf die Leistung konzipiert sind.

Diese Funktion verwendet den folgenden alternativen Namen:

  • RtlIntToByte
  • RtlInt32ToByte
  • RtlInt32ToUInt8

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile ntintsafe.h