次の方法で共有


RtlUnicodeToOemN 関数 (ntifs.h)

RtlUnicodeToOemN ルーチンは、現在のシステム OEM コード ページを使用して、特定の Unicode 文字列を OEM 文字列に変換します。

構文

NTSYSAPI NTSTATUS RtlUnicodeToOemN(
  [out]           PCHAR  OemString,
  [in]            ULONG  MaxBytesInOemString,
  [out, optional] PULONG BytesInOemString,
  [in]            PCWCH  UnicodeString,
  [in]            ULONG  BytesInUnicodeString
);

パラメーター

[out] OemString

変換された文字列を受け取る呼び出し元によって割り当てられたバッファーへのポインター。

[in] MaxBytesInOemString

OemStringに書き込まれる最大バイト数。

[out, optional] BytesInOemString

変換された文字列のバイト数を受け取る呼び出し元によって割り当てられた変数へのポインター。 このパラメーターは NULL できます。

[in] UnicodeString

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

[in] BytesInUnicodeString

UnicodeString の文字列のサイズ (バイト単位)します。

戻り値

RtlUnicodeToOemN は、UnicodeString の完全な文字列 変換され、OemStringで返された場合にSTATUS_SUCCESSを返します。

備考

戻り値STATUS_BUFFER_OVERFLOWでは、OemString 切り捨てられた文字列がエラーなしで変換されました。

戻り値STATUS_SUCCESSの場合、BytesInOemStringの値は、指定された MaxBytesInOemStringではなく、返される文字列の長さを示します。

RtlUnicodeToOemN ソース文字列は変更されません。 指定した BytesInUnicodeString NULL ターミネータが含まれている場合、および指定された MaxBytesInOemString が切り捨てを引き起こさなかった場合は、null で終了した OEM 文字列を返します。

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

必要条件

要件 価値
ターゲット プラットフォーム 万国
ヘッダー ntifs.h (Ntifs.h を含む)
ライブラリ NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

関連項目

RtlOemToUnicodeN する

RtlUnicodeStringToCountedOemString

RtlUnicodeStringToOemString