RtlUIntToUInt8-Funktion (ntintsafe.h)

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

Syntax

NTSTATUS RtlUIntToUInt8(
  [in]  UINT  uOperand,
  [out] UINT8 *pui8Result
);

Parameter

[in] uOperand

Der zu konvertierende Wert.

[out] pui8Result

Ein Zeiger auf den konvertierten Wert. Wenn die Konvertierung zu einer Kürzung des ursprünglichen Werts führt, 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 entwickelt wurden, um Typkonvertierungen bereitzustellen und Gültigkeitsprüfungen mit minimalen Auswirkungen auf die Leistung durchzuführen.

Diese Funktion verwendet den folgenden alternativen Namen:

  • RtlUIntToByte
  • RtlUInt32ToUInt8

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile ntintsafe.h