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

# GetHandle

> IDStorageFileX::GetHandle

# IDStorageFileX::GetHandle

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

## Syntax

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

### Parameters

此方法无参数。

### Return value

类型：HANDLE

## Remarks

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

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

有关详细信息，请参阅 [DirectStorage 概述](https://docs.xbox.com/zh-CN/build/console-features/storage/directstorage/directstorage-overview.md) 中的“IDStorageFileX”一节。

## Requirements

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

**库：** dstorage\_xs.lib

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

## See also

[IDStorageFactoryX::OpenFile](https://docs.xbox.com/zh-CN/reference/system/dstorage/interfaces/IDStorageFactoryX/methods/idstoragefactoryx_openfile.md)\
[IDStorageFileX](https://docs.xbox.com/zh-CN/reference/system/dstorage/interfaces/IDStorageFileX/idstoragefilex.md)


## Related topics

- [IDStorageFileX（接口内容）](https://docs.xbox.com/zh-CN/reference/system/dstorage/interfaces/IDStorageFileX/idstoragefilex.md)
- [DirectStorage 概述](https://docs.xbox.com/zh-CN/build/console-features/storage/directstorage/directstorage-overview.md)
- [GET (/handles/{handle-id})](https://docs.xbox.com/zh-CN/reference/live/rest/uri/sessiondirectory/uri-handleshandleidget.md)
- [GET (/handles/{handleId}/session)](https://docs.xbox.com/zh-CN/reference/live/rest/uri/sessiondirectory/uri-handleshandleidsessionget.md)
- [GetDescriptorHandleIncrementSize](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_getdescriptorhandleincrementsize_public.md)