次の方法で共有

RtlUnicodeStringToCountedOemString 関数 (ntifs.h)

  • [アーティクル]

RtlUnicodeStringToCountedOemString ルーチンは、現在のシステム OEM コード ページを使用して、指定された Unicode ソース文字列をカウントされた OEM 文字列に変換します。

構文

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

パラメーター

DestinationString

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

[in] SourceString

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

[in] AllocateDestinationString

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

戻り値

RtlUnicodeStringToCountedOemString 、DestinationString の文字列 変換された場合にSTATUS_SUCCESSを返します。 それ以外の場合、ストレージは割り当てられず、変換は実行されませんでした。 このルーチンは、指定された SourceString内の文字を変換できない場合にSTATUS_UNMAPPABLE_CHARACTERを返します。

備考

RtlUnicodeStringToCountedOemString は、NULL ターミネータを含まない翻訳された文字列を返します。 システムの起動時に現在のシステム コード ページとしてインストールされた OEM コード ページを使用して、指定されたソース文字列を変換します。

RtlUnicodeStringToCountedOemString ソース文字列は変更されません。

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

必要条件

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

関連項目

OEM_STRING

RtlFreeOemString の

RtlOemStringToCountedUnicodeString の

RtlUnicodeStringToOemString の

RtlUnicodeToOemN の

RtlUpcaseUnicodeStringToCountedOemString の

UNICODE_STRING