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

# IDStorageFileX::GetHandle

> IDStorageFileX::GetHandle

# IDStorageFileX::GetHandle

获取该对象所代表文件的 Win32 句柄。

## Syntax

```cpp theme={null}
HANDLE GetHandle(
)
```

### Parameters

此方法无参数。

### Return value

类型：HANDLE

## Remarks

该句柄以 `GENERIC_READ` 权限和 `FILE_SHARE_READ` 共享模式打开。可用于查询文件的相关信息，例如其大小。

不再需要该句柄时，请调用 `CloseHandle` 将其关闭。

有关详细信息，请参阅 [DirectStorage 概述](/build/console-features/storage/directstorage/directstorage-overview) 中的“IDStorageFileX”一节。

## Requirements

**头文件：** dstorage\_xs.h

**库：** dstorage\_xs.lib

**受支持的平台：** XBOX Series 主机

## See also

[IDStorageFactoryX::OpenFile](/reference/system/dstorage/interfaces/IDStorageFactoryX/methods/idstoragefactoryx_openfile)\
[IDStorageFileX](/reference/system/dstorage/interfaces/IDStorageFileX/idstoragefilex)


## Related topics

- [IDStorageFileX](/zh-CN/reference/system/dstorage/interfaces/IDStorageFileX/idstoragefilex.md)
- [DirectStorage 概述](/zh-CN/build/console-features/storage/directstorage/directstorage-overview.md)
- [IDStorageFileX::Close](/zh-CN/reference/system/dstorage/interfaces/IDStorageFileX/methods/idstoragefilex_close.md)
- [IDStorageFactoryX::OpenFile](/zh-CN/reference/system/dstorage/interfaces/IDStorageFactoryX/methods/idstoragefactoryx_openfile.md)
- [DStorage](/zh-CN/reference/system/dstorage/dstorage_members.md)