> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XTFFILEINFO

> XTFFILEINFO

# XTFFILEINFO

包含 XBOX Tools Framework (XTF) 應用程式所用之檔案的相關資訊。

## 語法

```cpp theme={null}
typedef struct XTFFILEINFO {
    LPCWSTR pszFileName;
    DWORD dwFileAttributes;
    ULONGLONG ullCreationTime;
    ULONGLONG ullLastAccessTime;
    ULONGLONG ullLastWriteTime;
    ULONGLONG ullFileSize;
    XTFFILEIORESERVED Reserved;
} XTFFILEINFO, *LPXTFFILEINFO;  
```

### 成員

*pszFileName*\
類型：LPCWSTR

指向檔案之檔案名稱的指標。

*dwFileAttributes*\
類型：DWORD

檔案之檔案屬性的位元 OR 組合。如需可能的屬性清單，請參閱[檔案屬性常數](https://msdn.microsoft.com/library/windows/desktop/gg258117\(v=vs.85\).aspx)。

*ullCreationTime*\
類型：ULONGLONG

檔案的建立日期和時間。

*ullLastAccessTime*\
類型：ULONGLONG

檔案的上次存取日期和時間。

*ullLastWriteTime*\
類型：ULONGLONG

檔案的上次寫入日期和時間。

*ullFileSize*\
類型：ULONGLONG

檔案的大小 (以位元組為單位)。

*Reserved*\
類型：[XTFFILEIORESERVED](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/structures/xtffileioreserved-xtffileio-xbox-microsoft-t.md)

保留供內部使用。

## 備註

此結構提供檔案的相關資訊，以供 XTF 應用程式使用。此結構包含檔案的名稱、檔案屬性和大小，以及檔案的建立、上次存取和上次寫入的日期和時間。

`XTFFILEINFO` 結構由 XtfFileIO API 中的其他介面成員使用，包括 [IXtfCopyFileCallback::OnEndFileCopy](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onendfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)、[IXtfCopyFileCallback::OnStartFileCopy](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onstartfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)、[IXtfFindFileCallback::OnFoundFile](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfFindFileCallback/methods/onfoundfile-ixtffindfilecallback-xtffileio-xbox-microsoft-m.md) 和 [IXtfFileIOClient::GetFileInfo](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/getfileinfo-ixtffileioclient-xtffileio-xbox-microsoft-m.md)。

## 需求

**標頭：** xtffileio.h

**程式庫：** xtffileio.lib

**支援的平台：** Windows (適用於 XBOX 主機工具)

## 另請參閱

[IXtfCopyFileCallback::OnEndFileCopy](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onendfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)\
[IXtfCopyFileCallback::OnStartFileCopy](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onstartfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)\
[IXtfFindFileCallback::OnFoundFile](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfFindFileCallback/methods/onfoundfile-ixtffindfilecallback-xtffileio-xbox-microsoft-m.md)\
[IXtfFileIOClient::GetFileInfo](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/getfileinfo-ixtffileioclient-xtffileio-xbox-microsoft-m.md)\
[XtfFileIO](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/xtffileio-xbox-microsoft-n.md)


## Related topics

- [XTFFILEIORESERVED](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/structures/xtffileioreserved-xtffileio-xbox-microsoft-t.md)
- [GetFileInfo](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/getfileinfo-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [XtfFileIO (API 內容)](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/xtffileio-xbox-microsoft-n.md)
- [OnEndFileCopy](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onendfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [OnFoundFile](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfFindFileCallback/methods/onfoundfile-ixtffindfilecallback-xtffileio-xbox-microsoft-m.md)