FsRtlRemoveDotsFromPath, fonction (ntifs.h)

Article
02/26/2024

La routine FsRtlRemoveDotsFromPath supprime les occurrences inutiles de '.' et '..' à partir du chemin d’accès spécifié.

Syntaxe

NTSTATUS FsRtlRemoveDotsFromPath(
  [in, out] PWSTR  OriginalString,
  [in]      USHORT PathLength,
  [out]     USHORT *NewLength
);

Paramètres

[in, out] OriginalString

Pointeur vers la mémoire tampon à traiter.

[in] PathLength

Longueur de la mémoire tampon (en octets).

[out] NewLength

Pointeur vers la nouvelle longueur de la mémoire tampon, après le traitement.

Valeur retournée

La routine FsRtlRemoveDotsFromPath retourne STATUS_SUCCESS valeur de réussite ou STATUS_IO_REPARSE_DATA_INVALID si l’opération n’a pas pu être effectuée.

Remarques

Cette routine prend un chemin d’accès originalString comme dans l’exemple suivant :

\dir1\dir2\..\dir3\.\file.txt

La routine modifie OriginalString comme suit :

\dir1\dir3\file.txt

La routine échoue avec STATUS_IO_REPARSE_DATA_INVALID si l’une des chaînes suivantes est passée en tant que OriginalString :

\..
..
..\anyOtherContent

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Plateforme cible	Universal
En-tête	ntifs.h (include FltKernel.h, Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Règles de conformité DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Partager via