RtlIsValidOemCharacter function (ntifs.h)

Article
02/22/2024

The RtlIsValidOemCharacter routine determines if the specified Unicode character can be mapped to a valid OEM character.

Syntax

NTSYSAPI BOOLEAN RtlIsValidOemCharacter(
  [in, out] PWCHAR Char
);

Parameters

[in, out] Char

Pointer to the character. If the character can be mapped to a valid OEM character, this parameter receives the Unicode translation of the valid OEM character.

Return value

RtlIsValidOemCharacter returns TRUE if the character can be mapped to a valid OEM character, FALSE otherwise.

Remarks

RtlIsValidOemCharacter translates the Unicode character at Char using the OEM code page that was installed as the current system code page at system boot time, and converts the translated character to uppercase. RtlIsValidOemCharacter checks that the resulting character is a valid OEM character.

For information about other string-handling routines, see Run-Time Library (RTL) Routines.

Requirements

Requirement	Value
Minimum supported client	Windows 2000
Target Platform	Universal
Header	ntifs.h (include Ntifs.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL