Partager via


FsRtlRemoveDotsFromPath, fonction (ntifs.h)

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 traitement.

Valeur de retour

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

Remarques

Cette routine prend un chemin d’accès comme 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

Exigences

Exigence Valeur
client minimum pris en charge Windows Vista
plateforme cible Universel
d’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)