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

# IXtfFileIOClient::GetFileInfo Method

检索有关开发主机上指定文件的信息。

## 语法

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

### 参数

*pszFileName*\
类型：LPCWSTR

指向要获取其大小的文件的文件名的指针。

*pFileInfo*\
类型：LPXTFFILEINFO

指向接收文件信息的 [XTFFILEINFO](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t.md) 结构的指针。

### 返回值

类型：HRESULT

如果成功，则返回 `S_OK`；否则返回 HRESULT 错误代码。

## 备注

此函数以 [XTFFILEINFO](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t.md) 结构的形式获取开发主机上指定文件的信息，包括名称、文件属性、创建时间、上次访问时间、上次写入时间和大小。如果发生错误，此函数将返回 HRESULT 错误代码。有关特定于 XBOX 工具框架 (XTF) API 的 HRESULT 错误代码的详细信息，请参阅 [XTF 传输错误 (NDA 主题)](https://docs.xbox.com/zh-CN/tools/tools-console/commandlinetools/xtf-transport-errors.md)。

## 要求

**头文件：** xtffileio.h

**库：** xtffileio.lib

**支持的平台：** Windows（用于 XBOX 主机工具）

## 另请参阅

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


## Related topics

- [GetFileAttributes](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/getfileattributes-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [XTFFILEINFO](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t.md)
- [GetFileSize](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/getfilesize-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [IXtfFileIOClient 接口（接口内容）](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/ixtffileioclient-xtffileio-xbox-microsoft-t.md)
- [WdCopyFileProgressInfo](https://docs.xbox.com/zh-CN/reference/remoting/structs/wdcopyfileprogressinfo.md)