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) |