次の方法で共有

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 文字列を返します。

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

必要条件

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

関連項目

RtlUnicodeStringToOemSize の

RtlUnicodeToOemN の

RtlUpcaseUnicodeStringToCountedOemString の

RtlUpcaseUnicodeStringToOemString の