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

# GetFileInfo

> IXtfFileIOClient::GetFileInfo 方法

# IXtfFileIOClient::GetFileInfo 方法

擷取開發主機上指定檔案的相關資訊。

## 語法

```cpp theme={null}
public:
HRESULT GetFileInfo(
         LPCWSTR pszFileName,
         LPXTFFILEINFO pFileInfo
)  
```

### 參數

*pszFileName*\
類型：LPCWSTR

指向要取得其大小之檔案的檔案名稱指標。

*pFileInfo*\
類型：LPXTFFILEINFO

指向接收檔案資訊之 [XTFFILEINFO](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t.md) 結構的指標。

### 傳回值

類型：HRESULT

如果成功，則傳回 `S_OK`；否則傳回 HRESULT 錯誤碼。

## 備註

此函式會以 [XTFFILEINFO](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t.md) 結構的形式，取得開發主機上指定檔案的資訊，包括名稱、檔案屬性、建立時間、上次存取時間、上次寫入時間和大小。如果發生錯誤，此函式會傳回 HRESULT 錯誤碼。如需 XBOX Tools Framework (XTF) API 特有之 HRESULT 錯誤碼的詳細資訊，請參閱 [XTF 傳輸錯誤 (NDA 主題)](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/xtf-transport-errors.md)。

## 需求

**標頭：** xtffileio.h

**程式庫：** xtffileio.lib

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

## 另請參閱

[IXtfFileIOClient::GetFileAttributes](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/getfileattributes-ixtffileioclient-xtffileio-xbox-microsoft-m.md)\
[IXtfFileIOClient::GetFileSize](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/getfilesize-ixtffileioclient-xtffileio-xbox-microsoft-m.md)\
[IXtfFileIOClient 介面](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/ixtffileioclient-xtffileio-xbox-microsoft-t.md)\
[XtfFileIO](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/xtffileio-xbox-microsoft-n.md)


## Related topics

- [GetFileAttributes](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/getfileattributes-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [XTFFILEINFO](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t.md)
- [GetFileSize](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/getfilesize-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [IXtfFileIOClient 介面 (介面內容)](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/ixtffileioclient-xtffileio-xbox-microsoft-t.md)
- [WdCopyFileProgressInfo](https://docs.xbox.com/zh-TW/reference/remoting/structs/wdcopyfileprogressinfo.md)