Funzione FsRtlAreNamesEqual (ntifs.h)

La routine FsRtlAreNamesEqual determina se due stringhe Unicode sono uguali.

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. Non può contenere caratteri jolly.

[in] ConstantNameB

Puntatore alla seconda stringa. Non può 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 restituisceTRUE se le due stringhe Unicode corrispondono, FALSE in caso contrario.

Commenti

La tabella a cui punta UpcaseTable è una matrice di caratteri Unicode maiuscoli, indicizzata dal carattere Unicode da convertire in lettere maiuscole. 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 lettere maiuscole prima che vengano confrontate. Il valore di UpcaseTable, se specificato, viene quindi 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).

Requisiti

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)

Vedi anche

RtlEqualUnicodeString

UNICODE_STRING