@@ -472,21 +472,14 @@ pub trait MetadataExt {
472
472
#[ unstable( feature = "windows_by_handle" , issue = "63010" ) ]
473
473
fn file_index ( & self ) -> Option < u64 > ;
474
474
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.
479
476
///
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.
484
479
///
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.
490
483
#[ unstable( feature = "windows_change_time" , issue = "121478" ) ]
491
484
fn change_time ( & self ) -> Option < u64 > ;
492
485
}
0 commit comments