RtlUnicodeToMultiByteSize 関数 (ntifs.h)

RtlUnicodeToMultiByteSize ルーチンは、指定された Unicode 文字列のマルチバイト変換を格納するために必要なバイト数を決定します。 変換は、現在のシステム ANSI コード ページ (ACP) を使用することを前提としています。

構文

NTSYSAPI NTSTATUS RtlUnicodeToMultiByteSize(
  [out] PULONG BytesInMultiByteString,
  [in]  PCWCH  UnicodeString,
  [in]  ULONG  BytesInUnicodeString
);

パラメーター

[out] BytesInMultiByteString

変換された文字列を格納するために必要なバイト数を受け取る呼び出し元によって割り当てられた変数へのポインター。

[in] UnicodeString

マルチバイト長を計算する Unicode 文字列へのポインター。

[in] BytesInUnicodeString

ソース文字列の長さ (バイト単位)。

戻り値

RtlUnicodeToMultiByteSize はSTATUS_SUCCESSを返します。

注釈

RtlUnicodeToMultiByteSize は、RtlUnicodeToMultiByteN または RtlUpcaseUnicodeToMultiByteN を使用して Unicode 文字列を ANSI に変換する前に、割り当てるメモリの量、または MaxBytesInMultiByteString に指定する値を決定するために呼び出すことができます。 返される値には、ANSI 文字列の NULL 終端記号のスペースは含まれません。

RtlUnicodeToMultiByteN と同様に、RtlUnicodeToMultiByteSize では、システム起動時にインストールされている現在のシステム ANSI コード ページにマップされる事前計算済みの Unicode 文字のみがサポートされます。

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

要件

こちらもご覧ください

RtlMultiByteToUnicodeSize

RtlUnicodeToMultiByteN

RtlUpcaseUnicodeToMultiByteN