共用方式為

WdmlibRtlInitUnicodeStringEx 函式 （wdmsec.h）

  • 發行項

WdmlibRtlInitUnicodeStringEx 函式會初始化 Unicode 字元的計數位符串。

語法

NTSTATUS WdmlibRtlInitUnicodeStringEx(
  [out]          PUNICODE_STRING DestinationString,
  [in, optional] PCWSTR          SourceString
);

參數

[out] DestinationString

要初始化之 UNICODE_STRING 結構的指標。

[in, optional] SourceString

以 Null 結束之寬字元字串的指標。 此字串用來初始化 destinationString 所指向的計數位符串。

傳回值

WdmlibRtlInitUnicodeStringEx 如果成功，則會傳回STATUS_SUCCESS，否則方法可能會傳回其他 NTSTATUS 值。

言論

例程會將 sourceString 指標值複製到 DestinationString所指向之 UNICODE_STRING 結構 Buffer 成員。 這個結構的 Length 成員會設定為來源字元串的長度，以位元組為單位，但不包括終止 Null。 結構 MaximumLength 成員會設定為來源字元串的長度，以位元組為單位，包括終止 Null。 如果 sourceString 為 NULL ，Length 和 MaximumLength 都會設定為零。

WdmlibRtlInitUnicodeStringEx 不會改變 sourceString 所指向的來源字串。

注意

如果來源字串長度超過 MAX_USTRING - 1 個字節（其中 MAX_USTRING = 0xfffe），WdmlibRtlInitUnicodeStringEx 會將 DestinationString 所指向之 UNICODE_STRING 結構的 Length 成員設定為 MAX_USTRING - 2， 和 會將這個結構的 MaximumLength 成員設定為 MAX_USTRING。 在此情況下，Length 和 MaximumLength 值誤報以 Null 終止來源字串的長度，並依賴這些值的精確度可能十分危險。

WdmlibRtlInitUnicodeStringEx 的呼叫者可以在 IRQL <= DISPATCH_LEVEL 執行，如果 DestinationString 緩衝區不可分頁。 通常，呼叫端會在 IRQL = PASSIVE_LEVEL 執行，因為大多數其他 RtlXxxString 例程無法在 IRQL > PASSIVE_LEVEL 呼叫。

要求

要求 價值
最低支援的用戶端 從 Windows 2000 開始提供。
目標平臺 普遍
標頭 wdmsec.h （包括 Wdmsec.h、Wdm.h、Ntddk.h、Ntifs.h）
連結庫 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL 請參閱一節。

另請參閱