RtlCopyUnicodeString 函式 (wdm.h)

  • 發行項

RtlCopyUnicodeString 例程會將來源字串複製到目的地字串。

語法

NTSYSAPI VOID RtlCopyUnicodeString(
  [in, out]      PUNICODE_STRING  DestinationString,
  [in, optional] PCUNICODE_STRING SourceString
);

參數

[in, out] DestinationString

目的地字串緩衝區的指標。 此參數指向 UNICODE_STRING 結構。

[in, optional] SourceString

來源字串緩衝區的指標。 此參數指向 UNICODE_STRING 結構。

傳回值

無

備註

如果 SourceString 為 NULL，此例程會將 DestinationString 所指向之結構的 Length 字段設定為零。

此例程不會修改 DestinationString 所指向結構的 MaximumLength 和 Buffer 字段。

從來源字串複製的位元組數目是 SourceStr) ing 所指向之結構的 Length 成員所指定的來源字串長度 (，或由 DestinationString 所指向之結構的 MaximumLength 成員所指定的目的地字串長度上限， (由 DestinationString 所指向之結構的 MaximumLength 成員所指定的長度上限) 。無論哪一個成員較小。

呼叫端必須先正確初始化 DestinationString 所指向之結構的所有成員，再呼叫 RtlCopyUnicodeString。 呼叫這個例程之前，無法初始化 Length 或 MaximumLength 成員，可能會導致緩衝區溢出。

如果呼叫端在 IRQL >= DISPATCH_LEVEL執行，DestinationString 和 SourceString 緩衝區必須存留。

規格需求

需求 值
最低支援的用戶端 從 Windows 2000 開始提供。
目標平台 Universal
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h、Wudfwdm.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe (核心模式) ;Ntdll.dll (使用者模式)
IRQL 任何層級 (請參閱一節)

另請參閱

RtlCopyString

UNICODE_STRING