Funzione RtlInsertUnicodePrefix (ntifs.h)

  • Articolo

La routine RtlInsertUnicodePrefix inserisce un nuovo elemento in una tabella prefisso Unicode.

Sintassi

NTSYSAPI BOOLEAN RtlInsertUnicodePrefix(
  [in]  PUNICODE_PREFIX_TABLE            PrefixTable,
  [in]  __drv_aliasesMem PUNICODE_STRING Prefix,
  [out] PUNICODE_PREFIX_TABLE_ENTRY      PrefixTableEntry
);

Parametri

[in] PrefixTable

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

[in] Prefix

Puntatore alla stringa del nome da inserire con l'elemento in PrefixTableEntry.

[out] PrefixTableEntry

Puntatore all'archiviazione allocata del chiamante, che deve essere almeno sizeof(UNICODE_PREFIX_TABLE_ENTRY), per l'elemento da inserire per il nuovo prefisso. RtlInsertUnicodePrefix inizializza questo elemento, che deve essere considerato opaco dal chiamante.

Valore restituito

RtlInsertUnicodePrefix restituisce TRUE se il nuovo elemento è stato inserito nella tabella del prefisso oppure restituisce FALSE se esiste già un elemento duplicato nella tabella del prefisso.

Commenti

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

Dopo aver inserito il nuovo elemento, RtlInsertUnicodePrefix 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 di tabella prefisso inizializzata deve essere considerata opaca.

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

Per informazioni sulle 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 < DISPATCH_LEVEL

Vedi anche

RtlFindUnicodePrefix

RtlInitializeUnicodePrefix

RtlNextUnicodePrefix

RtlRemoveUnicodePrefix

UNICODE_STRING