RtlLongPtrToUChar-Funktion (ntintsafe.h)

Konvertiert einen Wert vom Typ LONG_PTR in einen Wert vom Typ UCHAR.

Syntax

NTSTATUS RtlLongPtrToUChar(
  [in]  LONG_PTR lOperand,
  [out] UCHAR    *pch
);

Parameter

[in] lOperand

Der zu konvertierende Wert.

[out] pch

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:

  • RtlSSIZETToUChar

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile ntintsafe.h