Funzione FsRtlIsNameInExpression (ntifs.h)

  • Articolo

La routine FsRtlIsNameInExpression determina se una stringa Unicode corrisponde al modello 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 criterio. Può contenere caratteri jolly. Se IgnoreCase è TRUE, Expression deve essere maiuscola.

[in] Name

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

FsRtlIsNameInExpression restituisceTRUE 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 all'oggetto finale. nel nome.

In condizioni di risorse ridotte, 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 Structured Exception Handling.For more information, see Structured Exception Handling.

Nota

Se solo uno dei parametri stringa ha una lunghezza pari a zero, FsRtlIsNameInExpression restituisceFALSE. Ciò significa che "*" non corrisponde a una stringa Null.

Se entrambi i parametri sono stringhe Null, FsRtlIsNameInExpression restituisceTRUE.

Requisiti

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)

Vedi anche

FsRtlIsDbcsInExpression

UNICODE_STRING