RtlUpcaseUnicodeStringToOemString 関数 (ntifs.h)

[アーティクル]
02/29/2024

RtlUpcaseUnicodeStringToOemString ルーチンは、現在のシステム OEM コードページを使用して、特定の Unicode ソース文字列を大文字の OEM 文字列に変換します。

構文

NTSYSAPI NTSTATUS RtlUpcaseUnicodeStringToOemString(
       POEM_STRING      DestinationString,
  [in] PCUNICODE_STRING SourceString,
  [in] BOOLEAN          AllocateDestinationString
);

パラメーター

DestinationString

カウントされた OEM 文字列を受け取る呼び出し元によって割り当てられたバッファーへのポインター。 AllocateDestinationString が FALSE の場合、呼び出し元は、OEM データを保持するために DestinationString の Buffer メンバーのバッファーも割り当てる必要があります。 AllocateDestinationString が TRUE の場合、RtlUpcaseUnicodeStringToOemString は文字列を保持するのに十分な大きさのバッファーを割り当て、Buffer にポインターを渡し、それに応じて DestinationString の長さと最大長のメンバーを更新します。

[in] SourceString

変換する Unicode 文字列へのポインター。

[in] AllocateDestinationString

RtlUpcaseUnicodeStringToOemString が DestinationString のバッファー領域を割り当てる必要がある場合は TRUE、それ以外の場合は FALSE に設定します。このパラメーターが TRUE の場合、 RtlFreeOemString を呼び出すことでバッファーが不要になったときに、呼び出し元がバッファーを解放します。

戻り値

RtlUpcaseUnicodeStringToOemString は 、DestinationString の文字列が変換された場合にSTATUS_SUCCESSを返します。それ以外の場合、ストレージは割り当てられなかったし、変換も実行されなかった。

注釈

RtlUpcaseUnicodeStringToOemString は、システム起動時に現在のシステムコードページとしてインストールされた OEM コードページを使用して、指定されたソース文字列を変換し、OEM 文字列を大文字に変換します。

このルーチンは、現在のコードページにマップできないすべてのソース文字列文字の変換先文字列の既定の文字を置き換えてから、STATUS_SUCCESSを返すことができます。

このルーチンでは、ソース文字列は変更されません。 NULL で終わる OEM 文字列を返します。

その他の文字列処理ルーチンの詳細については、「ランタイムライブラリ (RTL) ルーチン」を参照してください。

要件

要件	値
対象プラットフォーム	ユニバーサル
Header	ntifs.h (Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	< DISPATCH_LEVEL