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 文字列を返します。
その他の文字列処理ルーチンについては、「Run-Time ライブラリ (RTL) ルーチン」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | ntifs.h (Ntifs.h を含む) |
| ライブラリ | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |
関連項目
RtlMultiByteToUnicodeN の
RtlUnicodeToMultiByteN の
RtlUnicodeToMultiByteSize の