Funzione FsRtlIsNameInUnUpcasedExpression (ntifs.h)
La routine FsRtlIsNameInUnUpcasedExpression determina se una stringa Unicode corrisponde al criterio specificato. A differenza della routine FsRtlIsNameInExpression, FsRtlIsNameInUnUpcasedExpression non prevede che l'espressione sia in maiuscolo se IgnoreCase è TRUE.
Sintassi
BOOLEAN FsRtlIsNameInUnUpcasedExpression(
PUNICODE_STRING Expression,
PUNICODE_STRING Name,
BOOLEAN IgnoreCase,
PWCH UpcaseTable
);
Parametri
Expression
Puntatore alla stringa del pattern. Può contenere caratteri jolly. Se IgnoreCase è TRUE, Expression deve essere in minuscolo.
Name
Puntatore alla stringa da confrontare con il modello. Impossibile contenere caratteri jolly.
IgnoreCase
Impostare su TRUE per la corrispondenza senza distinzione tra maiuscole e minuscole, false in caso contrario.
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
Restituisce TRUE se la stringa corrisponde al criterio, FALSE in caso contrario.
Osservazioni
Nella stringa del criterio è possibile usare i caratteri jolly seguenti:
| Carattere jolly | Significato |
|---|---|
| * (asterisco) | Trova la corrispondenza con zero o più caratteri. |
| ? (punto interrogativo) | Trova la corrispondenza con un singolo carattere. |
| DOS_DOT | Trova una corrispondenza con un punto o zero caratteri oltre la stringa del nome. |
| DOS_QM | Trova la corrispondenza con un singolo carattere o, quando si verifica un punto o una fine della stringa del nome, sposta l'espressione alla fine del set di DOS_QMs contigui. |
| DOS_STAR | Trova la corrispondenza con zero o più caratteri fino a quando non viene rilevato e corrispondente al punto finale nel nome. |
nota
Se solo uno dei parametri stringa ha una lunghezza pari a zero, FsRtlIsNameInUnUpcasedExpression restituisce FALSE. Ciò significa che "*" non corrisponde a una stringa Null. Se entrambi i parametri sono stringhe Null, FsRtlIsNameInUnUpcasedExpression restituisce TRUE.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 10 (versione 1803) |
| piattaforma di destinazione | Universale |
| intestazione |
ntifs.h |
| libreria |
NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |