Función RtlInsertUnicodePrefix (ntifs.h)
La rutina RtlInsertUnicodePrefix inserta un nuevo elemento en una tabla de prefijo Unicode.
Sintaxis
NTSYSAPI BOOLEAN RtlInsertUnicodePrefix(
[in] PUNICODE_PREFIX_TABLE PrefixTable,
[in] __drv_aliasesMem PUNICODE_STRING Prefix,
[out] PUNICODE_PREFIX_TABLE_ENTRY PrefixTableEntry
);
Parámetros
[in] PrefixTable
Puntero a la tabla de prefijos. La tabla debe haberse inicializado llamando a RtlInitializeUnicodePrefix.
[in] Prefix
Puntero a la cadena de nombre que se va a insertar con el elemento en PrefixTableEntry.
[out] PrefixTableEntry
Puntero al almacenamiento asignado por el autor de la llamada, que debe ser al menos sizeof(UNICODE_PREFIX_TABLE_ENTRY), para que el elemento se inserte para el nuevo prefijo. RtlInsertUnicodePrefix inicializa este elemento, que el autor de la llamada debe considerar opaco.
Valor devuelto
RtlInsertUnicodePrefix devuelve TRUE si el nuevo elemento se insertó en la tabla de prefijos o devuelve FALSE si ya existe un elemento duplicado en la tabla de prefijos.
Comentarios
Cada entrada de prefijo de la tabla es un nombre de ruta de acceso relativo al directorio raíz de un volumen del sistema de archivos. Para tener un formato correcto, el prefijo debe comenzar con una sola barra diagonal inversa ().
Después de insertar el nuevo elemento, RtlInsertUnicodePrefix reequilibró el árbol de reproducción de la tabla de prefijos.
Los sistemas de archivos deben llamar a RtlInitializeUnicodePrefix para inicializar la tabla de prefijos antes de usar cualquier otro rtl.. Rutinas UnicodePrefix en él. La estructura de la tabla de prefijo inicializada debe considerarse opaca.
Llamadores de Rtl.. Las rutinas UnicodePrefix son responsables de sincronizar el acceso a la tabla de prefijos. Una exclusión mutua rápida es el mecanismo de sincronización más eficaz que se usará para este fin.
Para obtener información sobre otras rutinas de control de cadenas, vea Rutinas de la biblioteca en tiempo de ejecución (RTL).
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP |
| Servidor mínimo compatible | Windows Server 2003 |
| Plataforma de destino | Universal |
| Encabezado | ntifs.h (incluya Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |