FsRtlAreNamesEqual 函式 (ntifs.h)

  • 發行項

FsRtlAreNamesEqual 例程會判斷兩個 Unicode 字串是否相等。

語法

BOOLEAN FsRtlAreNamesEqual(
  [in]           PCUNICODE_STRING ConstantNameA,
  [in]           PCUNICODE_STRING ConstantNameB,
  [in]           BOOLEAN          IgnoreCase,
  [in, optional] PCWCH            UpcaseTable
);

參數

[in] ConstantNameA

第一個字串的指標。 不能包含通配符。

[in] ConstantNameB

第二個字串的指標。 不能包含通配符。

[in] IgnoreCase

若不區分大小寫比對，則設定為 TRUE ，否則為 FALSE 。

[in, optional] UpcaseTable

用於不區分大小寫比對之大寫字元數據表的選擇性指標。 如果未提供此值，則會使用預設的系統大寫字元表。

傳回值

如果兩個 Unicode 字串相符，FsRtlAreNamesEqual 會傳回 TRUE，否則為 FALSE。

備註

UpcaseTable 所指向的數據表是大寫 Unicode 字元的陣列，由要轉換成大寫的 Unicode 字元編製索引。 數位必須包含檔名中合法所有字元的專案。

在比較字串之前，會將這兩個字元串轉換成大寫來執行不區分大小寫的比對。 因此，只有在 IgnoreCase 為 TRUE 時，才會使用 UpcaseTable 的值。

如果集區配置失敗， FsRtlAreNamesEqual 會引發STATUS_NO_MEMORY例外狀況。

如需其他字串處理例程的資訊，請參閱 Run-Time Library (RTL) 例程。

規格需求

需求 值
目標平台 Universal
標頭 ntifs.h (包含 Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI 合規性規則 HwStorPortProhibitedDDIs (storport) 、 PowerIrpDDis (wdm)

另請參閱

RtlEqualUnicodeString

UNICODE_STRING