RtlUpcaseUnicodeToOemN 関数 (ntifs.h)

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

構文

NTSYSAPI NTSTATUS RtlUpcaseUnicodeToOemN(
  [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を返します。 それ以外の場合は、指定した MaxBytesInOemString に合わせてコピー先の文字列を切り捨てる必要がある場合は、STATUS_BUFFER_OVERFLOWを返すことができます。

注釈

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

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

このルーチンでは、ソース文字列は変更されません。 指定された BytesInUnicodeString に NULL ターミネータが含まれていて、指定された MaxBytesInOemString で切り捨てが発生しなかった場合は、NULL で終了する OEM 文字列が返されます。

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

要件

要件	値
対象プラットフォーム	ユニバーサル
Header	ntifs.h (Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	< DISPATCH_LEVEL

こちらもご覧ください

RtlUnicodeStringToOemSize

RtlUnicodeToOemN

RtlUpcaseUnicodeStringToCountedOemString

RtlUpcaseUnicodeStringToOemString