RtlUnicodeStringToOemString 関数 (ntifs.h)
RtlUnicodeStringToOemString ルーチンは、現在のシステム OEM コード ページを使用して、特定の Unicode ソース文字列を OEM 文字列に変換します。
構文
NTSYSAPI NTSTATUS RtlUnicodeStringToOemString(
POEM_STRING DestinationString,
[in] PCUNICODE_STRING SourceString,
[in] BOOLEAN AllocateDestinationString
);
パラメーター
DestinationString
OEM 文字列を受け取る呼び出し元によって割り当てられたバッファーへのポインター。 AllocateDestinationString が FALSE 場合、呼び出し元は OEM データを保持するために、DestinationString の Buffer メンバーのバッファーも割り当てる必要があります。 AllocateDestinationString が TRUE の場合、RtlUnicodeStringToOemString は文字列を保持するのに十分な大きさのバッファーを割り当て、Bufferでポインターを渡し、それに応じて DestinationString の長さと最大長のメンバー 更新します。
[in] SourceString
変換する Unicode 文字列へのポインター。
[in] AllocateDestinationString
RtlUnicodeStringToOemString DestinationStringのバッファー領域を割り当てる必要がある場合は、TRUE に設定 、それ以外の場合は FALSE。 このパラメーターが TRUE 場合、呼び出し元は、RtlFreeOemString 呼び出すことによって、バッファーが不要になったときにバッファーを解放する役割を担います。
戻り値
RtlUnicodeStringToOemString 、DestinationString の文字列 変換された場合にSTATUS_SUCCESSを返します。 それ以外の場合、ストレージは割り当てられず、変換は実行されませんでした。
備考
RtlUnicodeStringToOemString は、システム起動時に現在のシステム コード ページとしてインストールされた OEM コード ページを使用して、指定されたソース文字列を変換します。
RtlUnicodeStringToOemString ソース文字列は変更されません。 NULL で終わる OEM 文字列を返します。
その他の文字列処理ルーチンについては、「Run-Time ライブラリ (RTL) ルーチン」を参照してください。
必要条件
要件 | 価値 |
---|---|
ターゲット プラットフォーム の | 万国 |
ヘッダー | ntifs.h (Ntifs.h を含む) |
ライブラリ | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | < DISPATCH_LEVEL |
関連項目
RtlFreeOemString の
RtlUnicodeStringToCountedOemString の
RtlUnicodeStringToOemSize の
RtlUnicodeToOemN の
RtlUpcaseUnicodeStringToOemString の