Funzione FsRtlIsNameInUnUpcasedExpression (ntifs.h)

  • Articolo

La routine FsRtlIsNameInUnUpcasedExpression determina se una stringa Unicode corrisponde al modello specificato. A differenza della routine FsRtlIsNameInExpression, FsRtlIsNameInUnUpcasedExpression non prevede che Expression 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 criterio. Può contenere caratteri jolly. Se IgnoreCase è TRUE, Expression deve essere in lettere minuscole.

Name

Puntatore alla stringa da confrontare con il criterio. Non può 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.

Commenti

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 la corrispondenza con un punto o zero caratteri oltre la stringa del nome.
DOS_QM Trova la corrispondenza con qualsiasi carattere singolo o, in caso di corrispondenza di un punto o di 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.

Requisiti

Requisito Valore
Client minimo supportato Windows 10 (versione 1803)
Piattaforma di destinazione Universale
Intestazione ntifs.h
Libreria NtosKrnl.exe
IRQL PASSIVE_LEVEL

Vedi anche