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

こちらもご覧ください

RtlMultiByteToUnicodeN

RtlUnicodeToMultiByteN

RtlUnicodeToMultiByteSize