RtlOemStringToUnicodeString 関数 (ntifs.h)
RtlOemStringToUnicodeString ルーチンは、現在のシステム OEM コード ページを使用して、指定されたソース文字列を null で終わる Unicode 文字列に変換します。
構文
NTSYSAPI NTSTATUS RtlOemStringToUnicodeString(
PUNICODE_STRING DestinationString,
[in] PCOEM_STRING SourceString,
[in] BOOLEAN AllocateDestinationString
);
パラメーター
DestinationString
変換された文字列を受け取る呼び出し元によって割り当てられたバッファーへのポインター。 AllocateDestinationString が FALSE の場合、呼び出し元は、Null で終わる Unicode 文字列を保持するために DestinationString の Buffer メンバーのバッファーも割り当てる必要があります。 AllocateDestinationString が TRUE の場合、RtlOemStringToUnicodeString は文字列を保持するのに十分な大きさのバッファーを割り当て、Buffer にポインターを渡し、それに応じて DestinationString の長さと最大長のメンバーを更新します。
[in] SourceString
Unicode に変換する OEM 文字列へのポインター。
[in] AllocateDestinationString
RtlOemStringToUnicodeString が DestinationString のバッファー領域を割り当てる必要がある場合は TRUE、それ以外の場合は FALSE に設定します。 このパラメーターが TRUE の場合、呼び出し元は RtlFreeUnicodeString を呼び出して不要になったときにバッファーを解放します。
戻り値
RtlOemStringToUnicodeString は、 DestinationString で翻訳された文字列を返す場合、STATUS_SUCCESSを返します。 それ以外の場合、ストレージは割り当てられず、変換は行われませんでした。
注釈
RtlOemStringToUnicodeString は、システム起動時に現在のシステム コード ページとしてインストールされた OEM コード ページを使用して、指定されたソース文字列を変換します。
このルーチンでは、ソース文字列は変更されません。 NULL で終わる Unicode 文字列を返します。
その他の文字列処理ルーチンの詳細については、「 ランタイム ライブラリ (RTL) ルーチン」を参照してください。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| Header | ntifs.h (Ntifs.h を含む) |
| Library | NtosKrnl.lib |
| [DLL] | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |