| @@ -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 |
} |