次の方法で共有

RtlUpcaseUnicodeStringToOemString 関数 (ntifs.h)

  • [アーティクル]

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

構文

NTSYSAPI NTSTATUS RtlUpcaseUnicodeStringToOemString(
       POEM_STRING      DestinationString,
  [in] PCUNICODE_STRING SourceString,
  [in] BOOLEAN          AllocateDestinationString
);

パラメーター

DestinationString

カウントされた OEM 文字列を受け取る呼び出し元によって割り当てられたバッファーへのポインター。 AllocateDestinationString が FALSE 場合、呼び出し元は OEM データを保持するために、DestinationString の Buffer メンバーのバッファーも割り当てる必要があります。 AllocateDestinationString が TRUE 場合、RtlUpcaseUnicodeStringToOemString は、文字列を保持するのに十分な大きさのバッファーを割り当て、Bufferでポインターを渡し、それに応じて DestinationString の長さと最大長のメンバー 更新します。

[in] SourceString

変換する Unicode 文字列へのポインター。

[in] AllocateDestinationString

RtlUpcaseUnicodeStringToOemString が DestinationStringのバッファー領域を割り当てる必要がある場合は、TRUE に設定します。それ以外の場合は FALSE 。 このパラメーターが TRUE 場合、呼び出し元は、RtlFreeOemString 呼び出すことによって、バッファーが不要になったときにバッファーを解放する役割を担います。

戻り値

RtlUpcaseUnicodeStringToOemString 、DestinationString の文字列 変換された場合にSTATUS_SUCCESSを返します。 それ以外の場合は、ストレージが割り当てられておらず、変換も実行されませんでした。

備考

RtlUpcaseUnicodeStringToOemString は、システム起動時に現在のシステム コード ページとしてインストールされた OEM コード ページを使用して、指定されたソース文字列を変換し、OEM 文字列を大文字に変換します。

このルーチンは、現在のコード ページにマップできないすべてのソース文字列文字の変換先文字列の既定の文字を置き換えてから、STATUS_SUCCESS返すことができます。

このルーチンは、ソース文字列を変更しません。 NULL で終わる OEM 文字列を返します。

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

必要条件

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

関連項目

OEM_STRING

RtlFreeOemString の

RtlUnicodeStringToCountedOemString の

RtlUnicodeStringToOemSize の

RtlUnicodeStringToOemString の

RtlUpcaseUnicodeToOemN の

UNICODE_STRING