RtlUpcaseUnicodeStringToCountedOemString 関数 (ntifs.h)
RtlUpcaseUnicodeStringToCountedOemString ルーチンは、現在のシステム OEM コード ページを使用して、特定の Unicode ソース文字列を大文字でカウントされた OEM 文字列に変換します。
構文
NTSYSAPI NTSTATUS RtlUpcaseUnicodeStringToCountedOemString(
POEM_STRING DestinationString,
[in] PCUNICODE_STRING SourceString,
[in] BOOLEAN AllocateDestinationString
);
パラメーター
DestinationString
カウントされた OEM 文字列を受け取る呼び出し元によって割り当てられたバッファーへのポインター。 AllocateDestinationString が FALSE の場合、呼び出し元は、OEM データを保持するために DestinationString の Buffer メンバーのバッファーも割り当てる必要があります。 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 で返します
このルーチンでは、ソース文字列は変更されません。
その他の文字列処理ルーチンの詳細については、「 ランタイム ライブラリ (RTL) ルーチン」を参照してください。
要件
要件 | 値 |
---|---|
対象プラットフォーム | ユニバーサル |
Header | ntifs.h (Ntifs.h を含む) |
Library | NtosKrnl.lib |
[DLL] | NtosKrnl.exe |
IRQL | < DISPATCH_LEVEL |
こちらもご覧ください
RtlOemStringToCountedUnicodeString
RtlUnicodeStringToCountedOemString
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示