@@ -472,21 +472,14 @@ pub trait MetadataExt {
472472 #[ unstable( feature = "windows_by_handle" , issue = "63010" ) ]
473473 fn file_index ( & self ) -> Option < u64 > ;
474474
475- /// Returns the value of the `ChangeTime{Low,High}` field from the
476- /// [`FILE_BASIC_INFO`] struct associated with the current file handle.
477- /// [`ChangeTime`] is the last time file metadata was changed, such as
478- /// renames, attributes, etc.
475+ /// Returns the value of the `ChangeTime{Low,High}` fields of this metadata.
479476 ///
480- /// This will return `None` if `Metadata` was populated without access to
481- /// [`FILE_BASIC_INFO`]. For example, the result of `std::fs::read_dir`
482- /// will be derived from [`WIN32_FIND_DATA`] which does not have access to
483- /// `ChangeTime`.
477+ /// `ChangeTime` is the last time file metadata was changed, such as
478+ /// renames, attributes, etc.
484479 ///
485- /// [`FILE_BASIC_INFO`]: https://learn.microsoft.com/windows/win32/api/winbase/ns-winbase-file_basic_info
486- /// [`WIN32_FIND_DATA`]: https://learn.microsoft.com/windows/win32/api/minwinbase/ns-minwinbase-win32_find_dataw
487- /// [`FindFirstFile`]: https://learn.microsoft.com/windows/win32/api/fileapi/nf-fileapi-findfirstfilea
488- /// [`FindNextFile`]: https://learn.microsoft.com/windows/win32/api/fileapi/nf-fileapi-findnextfilea
489- /// [`ChangeTime`]: https://devblogs.microsoft.com/oldnewthing/20100709-00/?p=13463.
480+ /// This will return `None` if `Metadata` instance was created from a call to
481+ /// `DirEntry::metadata` or if the `target_vendor` is outside the current platform
482+ /// support for this api.
490483 #[ unstable( feature = "windows_change_time" , issue = "121478" ) ]
491484 fn change_time ( & self ) -> Option < u64 > ;
492485}
0 commit comments