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 の