FsRtlDissectName, fonction (ntifs.h)

Article
12/21/2024

Étant donné une chaîne de chemin d’accès Unicode, la routine FsRtlDissectName retourne deux chaînes, une contenant le premier nom de fichier trouvé dans la chaîne, l’autre contenant la partie restante sans analyse de la chaîne pathname.

Syntaxe

void FsRtlDissectName(
  [in]  UNICODE_STRING  Path,
  [out] PUNICODE_STRING FirstName,
  [out] PUNICODE_STRING RemainingName
);

Paramètres

[in] Path

Chaîne pathname à analyser.

[out] FirstName

Pointeur vers le premier nom de fichier dans la chaîne pathname.

[out] RemainingName

Pointeur vers la partie restante sans analyse de la chaîne pathname.

Valeur de retour

Aucun

Remarques

Dans la chaîne d’entrée, les barres obliques inverses sont lues en tant que séparateurs de noms. Le prénom de la chaîne est supposé être constitué de tous les caractères du début de la chaîne au caractère précédant la première barre oblique inverse, inclusive. Il n’existe qu’une seule exception à cette règle : si le premier caractère de la chaîne d’entrée est une barre oblique inverse, ce caractère est ignoré et n’apparaît pas dans la chaîne de sortie. La partie restante de la chaîne se compose de tous les caractères suivant la barre oblique inverse qui suit le prénom trouvé dans la chaîne.

FsRtlDissectName ne vérifie pas la présence de caractères non valides dans la chaîne d’entrée.

Le tableau suivant présente des exemples de valeurs d’entrée et de sortie pour FsRtlDissectName.

Chemin	FirstName	RemainingName
vide	vide	vide
Un	Un	vide
A\B\C\D\E	Un	B\C\D\E
*Un?	*Un?	vide
\Un	Un	vide
A[,]	A[,]	vide
A\\B+ ;\C	Un	\B+ ;\C

Notez que lors du retour, les membres de la mémoire tampon pointent vers le membre tampon de Path. Par conséquent, l’appelant ne doit pas allouer de stockage pour le Buffer membres des deux paramètres de sortie, comme illustré dans l’exemple suivant :

.
.
.
/*
The FsRtlDissectName routine will set the members
of the following two structures appropriately:
*/
UNICODE_STRING CurrentComponent;
UNICODE_STRING RemainingComponent;

/*
Do not allocate storage for the Buffer members of CurrentComponent
and RemainingComponent in that they will point into the previously
allocated storage of FullPathName's Buffer member:
*/
FsRtlDissectName (FullPathName, &CurrentComponent, &RemainingComponent);
.
.
.

Pour plus d’informations sur les autres routines de gestion des chaînes, consultez Run-Time Routines de bibliothèque (RTL).

Exigences

Exigence	Valeur
plateforme cible	Universel
d’en-tête	ntifs.h (include Ntifs.h)
bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
règles de conformité DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Voir aussi

UNICODE_STRING

Partager via