RtlUnicodeStringToOemString 関数 (winternl.h)

  • [アーティクル]

指定した Unicode ソース文字列を OEM 文字列に変換します。 変換は、OEM コード ページ (OCP) に関して行われます。

構文

NTSTATUS RtlUnicodeStringToOemString(
  [out] POEM_STRING      DestinationString,
  [in]  PCUNICODE_STRING SourceString,
  [in]  BOOLEAN          AllocateDestinationString
);

パラメーター

[out] DestinationString

Unicode ソース文字列と同等の OEM を含む OEM_STRING 構造体へのポインター。 AllocateDestinationString が TRUE の場合、MaximumLength フィールドが設定されます。

[in] SourceString

OEM に変換される UNICODE_STRING 構造体へのポインター。

[in] AllocateDestinationString

宛先文字列のバッファー領域の割り当てを制御します。

TRUE

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

FALSE

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

戻り値

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

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

注釈

このルーチンは、 DestinationString のみにバッファーを割り当てます。

要件

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