Funzione RtlNextUnicodePrefix (ntifs.h)

La routine RtlNextUnicodePrefix viene utilizzata per enumerare gli elementi in una tabella con prefisso Unicode.

Sintassi

NTSYSAPI PUNICODE_PREFIX_TABLE_ENTRY RtlNextUnicodePrefix(
  [in] PUNICODE_PREFIX_TABLE PrefixTable,
  [in] BOOLEAN               Restart
);

Parametri

[in] PrefixTable

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

[in] Restart

Impostare su TRUE se l'enumerazione deve iniziare dal primo elemento della tabella. Impostare su FALSE se si riprende l'enumerazione da una chiamata precedente.

Per enumerare tutti gli elementi nella tabella, usare RtlNextUnicodePrefix come indicato di seguito:

for (p = RtlNextUnicodePrefix ( Table, TRUE );
     p != NULL;
     p = RtlNextUnicodePrefix ( Table, FALSE )) {
        // Process the element pointed to by p
}

Valore restituito

RtlNextUnicodePrefix restituisce un puntatore all'elemento successivo, se presente. Se nella tabella non sono presenti altri elementi, RtlNextUnicodePrefix restituisce NULL.

Commenti

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

Vedi anche

RtlFindUnicodePrefix

RtlInitializeUnicodePrefix

RtlInsertUnicodePrefix

RtlRemoveUnicodePrefix