Funzione FsRtlIsNameInExpression (ntifs.h)
La routine FsRtlIsNameInExpression determina se una stringa Unicode corrisponde al criterio specificato.
Sintassi
BOOLEAN FsRtlIsNameInExpression(
[in] PUNICODE_STRING Expression,
[in] PUNICODE_STRING Name,
[in] BOOLEAN IgnoreCase,
[in, optional] PWCH UpcaseTable
);
Parametri
[in] Expression
Puntatore alla stringa del pattern. Può contenere caratteri jolly. Se IgnoreCase è TRUE, Expression deve essere maiuscola.
[in] Name
Puntatore alla stringa da confrontare con il modello. 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
FsRtlIsNameInExpression restituisce true se la stringa corrisponde al criterio, false in caso contrario.
Osservazioni
Nella stringa del criterio è possibile utilizzare 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 all'oggetto finale. nel nome. |
In condizioni di risorse basse, FsRtlIsNameInExpression può generare un'eccezione strutturata con un codice di STATUS_NO_MEMORY, che i chiamanti devono essere preparati a gestire. Per altre informazioni, vedere Gestione delle eccezioni strutturate.
Nota
Se solo uno dei parametri stringa ha una lunghezza pari a zero, FsRtlIsNameInExpression restituisce FALSE. Ciò significa che "*" non corrisponde a una stringa Null.
Se entrambi i parametri sono stringhe Null, FsRtlIsNameInExpression restituisce TRUE.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Questa routine è Windows 2000 |
| piattaforma di destinazione | Universale |
| intestazione | ntifs.h (include FltKernel.h, Ntifs.h) |
| libreria | NtosKrnl.lib |
| dll | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| regole di conformità DDI | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |