> ## 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 控制代碼。

## 語法

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

### 參數

此方法沒有參數。

### 傳回值

類型：HANDLE

## 備註

此控制代碼以 `GENERIC_READ` 權限和 `FILE_SHARE_READ` 共用模式開啟。它可用來查詢檔案的相關資訊，例如檔案大小。

不再需要此控制代碼時，請呼叫 `CloseHandle` 將其關閉。

如需詳細資訊，請參閱 [DirectStorage 概觀](https://docs.xbox.com/zh-TW/build/console-features/storage/directstorage/directstorage-overview.md)中的「IDStorageFileX」一節。

## 需求

**標頭：** dstorage\_xs.h

**程式庫：** dstorage\_xs.lib

**支援的平台：** XBOX Series 主機

## 另請參閱

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


## Related topics

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