次の方法で共有

RtlDowncaseUnicodeString 関数 (ntifs.h)

  • [アーティクル]

RtlDowncaseUnicodeString ルーチンは、指定した Unicode ソース文字列を小文字に変換します。 翻訳は、現在のシステム ロケール情報に準拠しています。

構文

NTSYSAPI NTSTATUS RtlDowncaseUnicodeString(
       PUNICODE_STRING  DestinationString,
  [in] PCUNICODE_STRING SourceString,
  [in] BOOLEAN          AllocateDestinationString
);

パラメーター

DestinationString

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

[in] SourceString

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

[in] AllocateDestinationString

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

戻り値

操作が成功すると、RtlDowncaseUnicodeString STATUS_SUCCESSが返されます。 それ以外の場合、ストレージは割り当てられず、変換も行われませんでした。

備考

呼び出し元 AllocateDestinationString を TRUE に設定すると、RtlDowncaseUnicodeString は、DestinationString の Buffer メンバーを、割り当てるバッファーへのポインターに置き換えます。 ルーチンからエラー状態コードが返された場合でも、古い値を上書きできます。

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

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

必要条件

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

関連項目

RtlFreeUnicodeString の

RtlUpcaseUnicodeString の

UNICODE_STRING