RtlUnicodeStringToAnsiString 関数 (wdm.h)

RtlUnicodeStringToAnsiString ルーチンは、指定された Unicode 文字列を ANSI 文字列に変換します。

構文

NTSYSAPI NTSTATUS RtlUnicodeStringToAnsiString(
  [in, out] PANSI_STRING     DestinationString,
  [in]      PCUNICODE_STRING SourceString,
  [in]      BOOLEAN          AllocateDestinationString
);

パラメーター

[in, out] DestinationString

変換された ANSI 文字列を保持する ANSI_STRING 構造体へのポインター。 AllocateDestinationString が TRUE の場合、ルーチンは文字列データを保持する新しいバッファーを割り当て、DestinationString の Buffer メンバーを更新して新しいバッファーを指します。 それ以外の場合、ルーチンは現在指定されているバッファーを使用して文字列を保持します。

[in] SourceString

ANSI に変換する Unicode ソース文字列へのポインター。

[in] AllocateDestinationString

このルーチンが DestinationString のバッファー領域を割り当てる場合は TRUE。 その場合は、 RtlFreeAnsiString を呼び出してバッファーの割り当てを解除する必要があります。

戻り値

変換が成功した場合、 RtlUnicodeStringToAnsiString はSTATUS_SUCCESSを返します。 それ以外の場合、ストレージは割り当てられず、変換も行われませんでした。

注釈

翻訳は、現在のシステムロケール情報に従って行われます。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 以降で使用できます。
対象プラットフォーム	ユニバーサル
Header	wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

こちらもご覧ください

ANSI_STRING

RtlAnsiStringToUnicodeString

RtlFreeAnsiString

UNICODE_STRING