RtlUpcaseUnicodeStringToCountedOemString 関数 (ntifs.h)

[アーティクル]
02/07/2025

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

構文

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

パラメーター

DestinationString

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

[in] SourceString

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

[in] AllocateDestinationString

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

戻り値

RtlUpcaseUnicodeStringToCountedOemString 、DestinationString で翻訳された文字列を返す場合STATUS_SUCCESSを返します。それ以外の場合は、ストレージが割り当てられておらず、変換も実行されませんでした。指定された SourceString内の文字を翻訳できない場合は、STATUS_UNMAPPABLE_CHARACTERを返します。

備考

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

特定のソース文字列で、著作権文字などの特殊文字に最適なマッピングを検索するには、RtlUpcaseUnicodeStringToCountedOemString 次の操作を実行します。

SourceString にある Unicode 文字列のコピーを OEM 文字列に変換します。
OEM 文字列を Unicode に変換します
この新しい Unicode 文字列を大文字に変換します
大文字の Unicode 文字列をカウントされた OEM 文字列に変換し、DestinationString 返します。

このルーチンは、ソース文字列を変更しません。

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

必要条件

要件	価値
ターゲットプラットフォームの	万国
ヘッダー	ntifs.h (Ntifs.h を含む)
ライブラリ	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	< DISPATCH_LEVEL

次の方法で共有

RtlUpcaseUnicodeStringToCountedOemString 関数 (ntifs.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース