RtlAppendUnicodeToString 関数 (wdm.h)

RtlAppendUnicodeToString ルーチンは、指定された Unicode 文字列をバッファー内の Unicode 文字列に連結します。

構文

NTSYSAPI NTSTATUS RtlAppendUnicodeToString(
  [in, out]      PUNICODE_STRING Destination,
  [in, optional] PCWSTR          Source
);

[in, out] Destination

バッファー内の文字列へのポインター。

[in, optional] Source

Destination 文字列に追加する null で終わる文字列へのポインター。

RtlAppendUnicodeToString は、次のいずれかを返すことができます。

リターンコード	説明
STATUS_SUCCESS	ソース文字列が宛先文字列に正常に追加され、追加されたバイトを含むように宛先文字列の長さが更新されました。
STATUS_BUFFER_TOO_SMALL	コピー先の文字列バッファーが小さすぎてソース文字列を追加できないため、変換先の文字列の長さは更新されず、宛先文字列バッファーの内容は変更されません。

RtlAppendUnicodeToString は、変換先の文字列の末尾にソース文字列を追加します。

コピー先のバッファーに、ソース文字列と変換先の文字列を連結した結果の文字列を格納するのに十分な大きさがない場合 (ソース文字列を終了する null 文字は含まれません)、ルーチンは STATUS_BUFFER_TOO_SMALLを返し、変換先の文字列は変更しません。

呼び出し元が IRQL >= DISPATCH_LEVELで実行されている場合、宛先バッファーは常駐である必要があります。

要件	値
サポートされている最小のクライアント	Windows 2000 以降で使用できます。
対象プラットフォーム	ユニバーサル
Header	wdm.h (Wdm.h、Ntddk.h、Ntifs.h、Wudfwdm.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe (カーネルモード);Ntdll.dll (ユーザーモード)
IRQL	「解説」を参照してください。