次の方法で共有

RtlUnicodeStringToAnsiString 関数 (winternl.h)

  • [アーティクル]

指定した Unicode ソース文字列を ANSI 文字列に変換します。

構文

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_STRING 構造体。

[in] AllocateDestinationString

DestinationString のバッファー領域の割り当てを制御します。

TRUE

DestinationString にはバッファー領域が割り当てられます。 TRUE に設定した場合、RtlFreeAnsiString を使用してバッファーの割り当てを解除する必要があります。

FALSE

DestinationString にはバッファー領域が割り当てられません。

戻り値

NTSTATUS には、さまざまな NTSTATUS 値が定義されています。H。DDK と共に分散されます。

リターン コード 説明
STATUS_SUCCESS
 Unicode 文字列が ANSI に変換されました。 それ以外の場合、ストレージは割り当てられず、変換は行われませんでした。

注釈

変換は、現在のシステム ロケール情報に関して行われます。

この関数にはインポート ライブラリがないため、 GetProcAddress を使用する必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winternl.h
Library ntdll.lib
[DLL] ntdll.dll;NtosKrnl.exe