Funzione FsRtlAreNamesEqual (ntifs.h)
La routine
Sintassi
BOOLEAN FsRtlAreNamesEqual(
[in] PCUNICODE_STRING ConstantNameA,
[in] PCUNICODE_STRING ConstantNameB,
[in] BOOLEAN IgnoreCase,
[in, optional] PCWCH UpcaseTable
);
Parametri
[in] ConstantNameA
Puntatore alla prima stringa. Impossibile contenere caratteri jolly.
[in] ConstantNameB
Puntatore alla seconda stringa. Impossibile contenere caratteri jolly.
[in] IgnoreCase
Impostare su TRUE per la corrispondenza senza distinzione tra maiuscole e minuscole, false in caso contrario.
[in, optional] UpcaseTable
Puntatore facoltativo alla tabella di caratteri maiuscoli da usare per la corrispondenza senza distinzione tra maiuscole e minuscole. Se questo valore non viene specificato, viene utilizzata la tabella dei caratteri maiuscoli di sistema predefinita.
Valore restituito
FsRtlAreNamesEqual restituisce TRUE se le due stringhe Unicode corrispondono, false in caso contrario.
Osservazioni
La tabella a cui punta UpcaseTable è una matrice di caratteri Unicode maiuscoli indicizzati dal carattere Unicode da convertire in maiuscolo. La matrice deve contenere voci per tutti i caratteri legali nei nomi di file.
La corrispondenza senza distinzione tra maiuscole e minuscole viene eseguita convertendo entrambe le stringhe in maiuscole prima che vengano confrontate. Pertanto, il valore di UpcaseTable, se specificato, viene utilizzato solo se IgnoreCase è TRUE.
Se si verifica un errore di allocazione del pool, FsRtlAreNamesEqual genera un'eccezione STATUS_NO_MEMORY.
Per informazioni su altre routine di gestione delle stringhe, vedere Routine RTL (Run-Time Library).
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| intestazione |
ntifs.h (include Ntifs.h) |
| libreria |
NtosKrnl.lib |
| dll | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| regole di conformità DDI | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |