RtlUpcaseUnicodeToMultiByteN 関数 (ntifs.h)
RtlUpcaseUnicodeToMultiByteN ルーチンは、現在のシステム ANSI コード ページ (ACP) を使用して、指定された Unicode 文字列を新しい大文字の文字列に変換します。 翻訳された文字列は、必ずしもマルチバイト文字セットからのものではありません。
構文
NTSYSAPI NTSTATUS RtlUpcaseUnicodeToMultiByteN(
[out] PCHAR MultiByteString,
[in] ULONG MaxBytesInMultiByteString,
[out, optional] PULONG BytesInMultiByteString,
[in] PCWCH UnicodeString,
[in] ULONG BytesInUnicodeString
);
パラメーター
[out] MultiByteString
変換された文字列を受け取る呼び出し元によって割り当てられたバッファーへのポインター。
[in] MaxBytesInMultiByteString
MultiByteString で書き込まれる最大バイト数。 この値によって変換された文字列が切り捨てられる場合、 RtlUpcaseUnicodeToMultiByteN はエラー状態を返しません。
[out, optional] BytesInMultiByteString
変換された文字列の長さをバイト単位で受け取る呼び出し元によって割り当てられた変数へのポインター。 このパラメーターは、NULL でもかまいません。
[in] UnicodeString
変換する Unicode ソース文字列へのポインター。
[in] BytesInUnicodeString
UnicodeString の文字列のサイズ (バイト単位)。
戻り値
RtlUpcaseUnicodeToMultiByteN は STATUS_SUCCESSを返します。
注釈
RtlUpcaseUnicodeToMultiByteN は、システムの起動時にインストールされている現在のシステム ANSI コード ページを使用して、指定された Unicode 文字列を変換し、変換された文字列を大文字に変換します。
このルーチンでは、ソース文字列は変更されません。 指定された BytesInUnicodeString に NULL ターミネータが含まれていて、指定された MaxBytesInMultiByteString で切り捨てが発生しなかった場合は、NULL で終わる ANSI 文字列が返されます。
その他の文字列処理ルーチンの詳細については、「 ランタイム ライブラリ (RTL) ルーチン」を参照してください。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| Header | ntifs.h (Ntifs.h を含む) |
| Library | NtosKrnl.lib |
| [DLL] | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |