Funzione RtlFindUnicodePrefix (ntifs.h)

  • Articolo

La routine RtlFindUnicodePrefix cerca la corrispondenza migliore per un determinato nome di file Unicode in una tabella con prefisso.

Sintassi

NTSYSAPI PUNICODE_PREFIX_TABLE_ENTRY RtlFindUnicodePrefix(
  [in] PUNICODE_PREFIX_TABLE PrefixTable,
  [in] PCUNICODE_STRING      FullName,
  [in] ULONG                 CaseInsensitiveIndex
);

Parametri

[in] PrefixTable

Puntatore alla tabella del prefisso. La tabella deve essere stata inizializzata chiamando RtlInitializeUnicodePrefix.

[in] FullName

Puntatore a una stringa Unicode contenente il percorso completo per un file.

[in] CaseInsensitiveIndex

Posizione nel nome file e nelle stringhe di prefisso in cui il confronto deve diventare senza distinzione tra maiuscole e minuscole. Il confronto tra stringhe fa distinzione tra maiuscole e minuscole per i primi caratteri CaseInsensitiveIndex in ogni stringa, senza distinzione tra maiuscole e minuscole per il resto della stringa.

Valore Significato
0 Il confronto tra stringhe non fa distinzione tra maiuscole e minuscole.
1..FullName.Length-1 Il confronto tra stringhe fa distinzione tra maiuscole e minuscole per i caratteri nelle posizioni da 0 a CaseInsensitiveIndex-1, senza distinzione tra maiuscole e minuscole per i caratteri dalla posizione CaseInsensitiveIndex alla fine della stringa.
FullName.Length Il confronto tra stringhe fa distinzione tra maiuscole e minuscole.

Valore restituito

RtlFindUnicodePrefix restituisce un puntatore al prefisso corretto più lungo trovato per la stringa specificata in FullName. Se non viene trovato alcun prefisso corrispondente, RtlFindUnicodePrefix restituisce NULL.

Commenti

Ogni voce di prefisso nella tabella è un percorso relativo alla directory radice di un volume del file system. Per essere ben formato, il prefisso deve iniziare con una singola barra rovesciata ().

Quando trova un prefisso corrispondente, RtlFindUnicodePrefix ribilancia l'albero di riproduzione della tabella del prefisso.

I file system devono chiamare RtlInitializeUnicodePrefix per inizializzare la tabella del prefisso prima di usare qualsiasi altro Rtl.. Routine UnicodePrefix su di esso. La struttura della tabella dei prefissi inizializzata deve essere considerata opaca.

Chiamanti del Rtl.. Le routine UnicodePrefix sono responsabili della sincronizzazione dell'accesso alla tabella del prefisso. Un mutex veloce è il meccanismo di sincronizzazione più efficiente da usare a questo scopo.

Per informazioni su altre routine di gestione delle stringhe, vedere Routine RTL (Run-Time Library).

Requisiti

Requisito Valore
Client minimo supportato Windows XP
Server minimo supportato Windows Server 2003
Piattaforma di destinazione Universale
Intestazione ntifs.h (include Ntifs.h)
Libreria NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

Vedi anche

RtlInitializeUnicodePrefix

RtlInsertUnicodePrefix

RtlNextUnicodePrefix

RtlRemoveUnicodePrefix

UNICODE_STRING